Difference between revisions of "Development/Simplifying entry for new developers"

Revision as of 23:23, 3 July 2009

Purpose of this initiative

This is an initiative started to make it easier for new developers to start to contribute to the project.

It identifies several issues which together might make contributing harder for interested developers.

The solutions will be applied to the contributing and development websites.

Workplaces

contributing.openoffice.org/tryouts/
programming.html
development.openoffice.org/tryouts/

Contact the Education Project, who aims to find future OpenOffice.org developers, mainly students, who are discovering OpenOffice.org Project. IRC dedicated Education Project channel is : #education.openoffice.org , server : irc.freenode.net

In the ClassRoom page, you probably will find information about the essentials. For example, you'll find on them Practice, or IRC Meetings Logs we did as "ClassRooms"

And if you think you can help fixing some bugs , please have a look at the Effort page

Possible issues

These are the possible problems identified:

Developers' Site map

Would work great on the development page as a top link.

http://development.openoffice.org/OpenOffice.org%20Developer%20Site%20Map.html

Building the software

Too many pages describe building the software. Consolidation would help new developers and increase clearness.

Getting it, Building, Hacking

These wiki pages need updating and cleanup for 3.1.

http://wiki.services.openoffice.org/wiki/Getting_It
http://wiki.services.openoffice.org/wiki/Building_OpenOffice.org
http://wiki.services.openoffice.org/wiki/Hacking

CVS and SVN

Articles covering code which is nowdays available in SVN instead should be updated.

Contribution - Programming

The page has a strange introduction, that begins with a to do list. Maybe the user already has an idea of what he would like to do. The page tells the user to start building the code. The programmer should learn what it is like to develop in the community first.

http://contributing.openoffice.org/programming.html

Building on Windows

Promotes ooo-build and says building the Vanilla build is painful.

http://wiki.services.openoffice.org/wiki/Windows#Using_vanilla_source

I want to be an OpenOffice.org developer wiki page

Suggest to delete the following page.

http://wiki.services.openoffice.org/wiki/I_want_to_be_an_OpenOffice.org_developer

Getting the source code

Create a guide that works for all operating systems, that everyone can point to.

http://wiki.services.openoffice.org/wiki/Getting_It
http://tools.openoffice.org/dev_docs/build_linux.html#GetTheSourceCode
http://tools.openoffice.org/dev_docs/build_windows_tcsh.html#BuildRequirements

Build Windows Tcsh

Is this page still valid?

http://tools.openoffice.org/dev_docs/build_windows_tcsh.html#BuildRequirements

Developer Types

New developers

Will start at contributing.openoffice.org or at development.openoffice.org
Want to know what is required of him/her
Want to learn the basics
Want to learn only the things that is required to do the work

Existing developers

Will start directly at development.openoffice.org
Want to get reference documentation
Want to have this information close at hand

Contributing related pages

These pages may be related or interesting to new developers.

Contributing Members

Per Eriksson
Martin Hollmichel
Mathias Bauer

@@ Line 24: / Line 24: @@
 http://development.openoffice.org/OpenOffice.org%20Developer%20Site%20Map.html
+=== Building the software ===
+Too many pages describe building the software. Consolidation would help new developers and increase clearness.
+http://wiki.services.openoffice.org/wiki/Building<br>
+http://wiki.services.openoffice.org/wiki/Building_OpenOffice.org<br>
+http://wiki.services.openoffice.org/wiki/Category:Distribution-Specific_Build_Instructions<br>
+http://wiki.services.openoffice.org/wiki/Building_ooo-build_on_Mac_OS_X<br>
+http://wiki.services.openoffice.org/wiki/Fedora_Build_Instructions<br>
+http://wiki.services.openoffice.org/wiki/OpenSUSE_Build_Instructions<br>
+http://wiki.services.openoffice.org/wiki/OpenSolaris_Build_Instructions<br>
+http://wiki.services.openoffice.org/wiki/SUSE9.3_Build_Instructions<br>
+http://wiki.services.openoffice.org/wiki/Ubuntu_Build_Instructions<br>
+http://wiki.services.openoffice.org/wiki/Prepared_Build_Images<br>
+http://wiki.services.openoffice.org/wiki/Building_OpenOffice.org<br>
+http://wiki.services.openoffice.org/wiki/Building_with_ooobuild<br>
+http://wiki.services.openoffice.org/wiki/MacOSXBuildInstructions<br>
+http://wiki.services.openoffice.org/wiki/GNULinuxSparcPorting<br>
+http://wiki.services.openoffice.org/wiki/Windows<br>
+http://wiki.services.openoffice.org/wiki/Build_Tool_Requirements<br>
+http://wiki.services.openoffice.org/wiki/O3-build<br>
+http://wiki.services.openoffice.org/wiki/Building_OOo_with_Cygwin_on_Windows<br>
+http://wiki.services.openoffice.org/wiki/Build_Requirements<br>
+http://wiki.services.openoffice.org/wiki/Build_Linux_Requirements<br>
+http://tools.openoffice.org/<br>
+http://wiki.services.openoffice.org/wiki/AquaBuild<br>
+http://wiki.services.openoffice.org/wiki/Running<br>
+http://tools.openoffice.org/background.html<br>
+http://tools.openoffice.org/tools/build.html<br>
+http://tools.openoffice.org/build_env_tools.html<br>
+http://tools.openoffice.org/build_env_mkfiles.html<br>
+http://tools.openoffice.org/dev_docs/build_linux.html<br>
+http://installation.openoffice.org/01RESPONSE_SO52_final_rev2.pdf<br>
+TODO: Continue with "Solaris" on tools.oo.o.
 === Getting it, Building, Hacking ===
 These wiki pages need updating and cleanup for 3.1.
-http://wiki.services.openoffice.org/wiki/Getting_It
+http://wiki.services.openoffice.org/wiki/Getting_It<br>
-http://wiki.services.openoffice.org/wiki/Building_OpenOffice.org
+http://wiki.services.openoffice.org/wiki/Building_OpenOffice.org<br>
 http://wiki.services.openoffice.org/wiki/Hacking