You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@openoffice.apache.org by bu...@apache.org on 2013/01/15 14:54:16 UTC
svn commit: r846720 - in /websites/staging/openoffice/trunk/content: ./
orientation/intro-development.html
Author: buildbot
Date: Tue Jan 15 13:54:16 2013
New Revision: 846720
Log:
Staging update by buildbot for openoffice
Modified:
websites/staging/openoffice/trunk/content/ (props changed)
websites/staging/openoffice/trunk/content/orientation/intro-development.html
Propchange: websites/staging/openoffice/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Tue Jan 15 13:54:16 2013
@@ -1 +1 @@
-1433034
+1433415
Modified: websites/staging/openoffice/trunk/content/orientation/intro-development.html
==============================================================================
--- websites/staging/openoffice/trunk/content/orientation/intro-development.html (original)
+++ websites/staging/openoffice/trunk/content/orientation/intro-development.html Tue Jan 15 13:54:16 2013
@@ -21,7 +21,7 @@
<meta name="google-site-verification" content="wIHUbgA-JO5PaJHpR5jeI8N9E2y2iF94o4oUwpaAdk8" />
<link href="/css/ooo.css" rel="stylesheet" type="text/css">
-<title>(Draft) Introduction to Development
</title>
+<title>(Draft) Introduction to Development</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<script type="text/javascript">
@@ -96,9 +96,9 @@
</div>
<div id="contenta">
- <h1 class="title">(Draft) Introduction to Development
</h1>
+ <h1 class="title">(Draft) Introduction to Development</h1>
<h2 id="introduction">Introduction</h2>
-<p>In this orientation module you will learn how to get started with development on OpenOffice. </p>
+<p>In this orientation module you will learn how to get started programming OpenOffice. </p>
<p>To complete this module, read through the material on this page, including the linked references. There will also
be some start-up tasks for you to perform, such as signing up for an account in our defect tracking database.</p>
<p>Your first task is to subscribe to our Development mailing list. You can subscribe by sending an email to
@@ -108,44 +108,52 @@ be some start-up tasks for you to perfor
We'd love to hear who you are, where you are from, what your background is, etc. Also as you work through the
items on this page, if you have questions or problems, please feel free to ask for help by sending a note to
this same list.</p>
-<p>Note: In parallel with the Dev-specific items on this page, you may want to first review the <a href="http://openoffice.apache.org/orientation/index.html">Level 1 and Level 2 Orientation Modules</a>
-as well. They have useful background information on The Apache Way, mailing list etiquette, decision making in the
+<p>Note: In parallel with the Dev-specific items on this page, you may want to also review the <a href="http://openoffice.apache.org/orientation/index.html">Level 1 and Level 2 Orientation Modules</a>. They have useful background information on The Apache Way, mailing list etiquette, decision making in the
project, etc. A quick review is a good idea, especially if you are new to working in Apache-style open source projects.</p>
<p>Now with the introductions out of the way, let's get started!</p>
<h2 id="openoffice-development-good-the-bad-and-the-ugly">OpenOffice Development: Good, the Bad and the Ugly</h2>
-<p>Let's be honest. The size, age and complexity of the C++ codebase makes coding a challenge. This is not a trivial codebase to learn. But if you like a good challenge then
-you'll like this project. There are tasks suitable for programmers with a range of programming experience, and we have many veteran OpenOffice hackers
+<p>Let's be honest. The size, age and complexity of OpenOffice's C++ codebase makes coding a challenge. This is not a trivial codebase to learn. But if you like a good challenge then
+you'll love this project! There are tasks suitable for programmers with a range of programming experience, and we have many veteran OpenOffice hackers
in the project who are happy to answer your questions. </p>
-<p>And in its favor, there are few other programs that you can help develop, that have the reach of OpenOffice. Many millions of users, and another million downloads every week,
-dowloaded from every country in the world (except North Korea). So the work you do, the bugs you fix, the features you add, will benefit millions of users around the world.</p>
+<p>And in its favor, there are few other programs that you can help develop, that have the reach of OpenOffice. Many millions of users depend on OpenOffice,
+with another million downloads every week, downloads from every country in the world (except North Korea). So the work you do, the bugs you fix,
+the features you add, will benefit millions of users around the world.</p>
<h2 id="building-openoffice">Building OpenOffice</h2>
-<p>Building OpenOffice on Linux or Mac is relatively easy, but expect the firt attempt to require some trial and error as you work on the configuration.</p>
-<p>Building on Windows is more complicated, due to the need to install more prerequistite tools.</p>
+<p>It all starts by establish a local build environment. Building OpenOffice on Linux or Mac is relatively easy,
+but expect the first attempt to require some trial and error. Every configuration is slightly different.</p>
+<p>Building on Windows is more complicated, due to the need to install more prerequisite tools.</p>
<p>Our <a href="http://wiki.openoffice.org/wiki/Documentation/Building_Guide">Building Guide</a> on the wiki is your starting point. Follow the instructions there, step by step. Ask questions on
the dev list if you get stuck. If you get an error it can be useful to search our <a href="http://markmail.org/search/+list:org.apache.incubator.ooo-dev">mailing list archives</a> to see if it
is a know problem with a known solution.</p>
+<p>Note also the the current list of configuration flags used in building the development snapshot builds at the
+bottom of the <a href="https://cwiki.apache.org/confluence/display/OOOUSERS/Development+Snapshot+Builds#DevelopmentSnapshotBuilds-AOO3.4.1">development snapshot builds page</a>.
+Although there are many other combinations of flags you can use, some of which are very useful for development, the flags on that page are what we use in our official releases.</p>
<p>Once you have a successful build, <a href="mailto:dev@openoffice.apache.org?subject=Succesful 1st Build!">post a note to the dev list</a> for some well-earned congratulations!</p>
<h2 id="finding-easy-tasks">Finding Easy Tasks</h2>
<p>As a new developer you will want to find some easy coding tasks. These are tasks that generally can be done with good C++ skills, but do not require comprehensive knowledge of how
OpenOffice is put together. The tasks are more localized. By doing easy tasks you gain experience and confidence hacking with the code base.</p>
<p>We use a <a href="https://issues.apache.org/ooo/">Bugzilla issue tracker</a> to track reported defects in OpenOffice. Some of us also use Bugzilla for tracking feature and enhancement tasks as well. The value of tracking
-all coding-related tasks in Bugzilla is that it helps our QA volunteer know what areas to test. Whether code was changed to fix a bug or enhance a feature -- the QA impact is pretty
+all coding-related tasks in Bugzilla is that it helps our QA volunteer know which areas to test. Whether code was changed to fix a bug or enhance a feature -- the QA impact is pretty
much the same.</p>
<p>If you have not done so already, please <a href="https://issues.apache.org/ooo/createaccount.cgi">sign up for a Bugzilla account</a>. This will allow you to enter new bugs or tasks, but also
assign yourself existing ones.</p>
-<p>Many tasks are classified in the "difficulty" field". The ones classified as "easy" or "simple" (one level harder than "easy") are good ones to start with. You can find these with the
-<a href="https://issues.apache.org/ooo/buglist.cgi?cmdtype=runnamed&namedcmd=easy-hacks&list_id=41609">easy-hacks</a> and <a href="https://issues.apache.org/ooo/buglist.cgi?cmdtype=runnamed&Bugzilla_restrictlogin=on&list_id=41611&namedcmd=simple-hacks">simple-tasks</a> queries.</p>
+<p>Many tasks are classified in the "difficulty" field. The ones classified as "easy" or "simple" (one level harder than "easy") are good ones to start with. You can find these with the
+<a href="https://issues.apache.org/ooo/buglist.cgi?cmdtype=runnamed&namedcmd=easy-hacks&list_id=41609">easy-hacks</a> and <a href="https://issues.apache.org/ooo/buglist.cgi?cmdtype=runnamed&list_id=41611&namedcmd=simple-hacks">simple-hacks</a> queries.</p>
<p>One you pick a bug and assign it to yourself, you might want to post a note to the dev list, letting us know. We might have some helpful hints to get you started.<br />
</p>
<h2 id="submitting-patches">Submitting Patches</h2>
-<p>As you read in the <a href="http://openoffice.apache.org/orientation/intro-contributing.html">Introduction to Contributing to OpenOffice module</a> contributors who have demonstrated merit via
-their project contributions can be voted in as Committers. Committers are the ability to check code into project's source control. Contributors who are nont (yet) Committers
+<p>As you read in the <a href="http://openoffice.apache.org/orientation/intro-contributing.html">Introduction to Contributing to OpenOffice module</a>, contributors who have demonstrated merit via
+their project contributions can be voted in as Committers. Committers have the ability to check code into project's source control. Contributors who are not (yet) Committers
must submit their patches and have them be reviewed first.</p>
<p>Please review these <a href="http://openoffice.apache.org/svn-basics.html#creating_and_submitting_patches">guidelines for submitting patches</a>. A good practice is to attach the patch to the
Bugzilla issue and then send a link to the issue to the Dev list, asking for someone to review and commit the patch.</p>
<h2 id="other-useful-resources">Other Useful Resources</h2>
<ul>
-<li>We have an <a href="https://fisheye6.atlassian.com/browse/ooo">instance of Altsassian Fisheye</a> which can be useful for browsing the code base and understanding dependencies.</li>
+<li>The <a href="http://wiki.openoffice.org/wiki/Documentation/DevGuide/OpenOffice.org_Developers_Guide">OpenOffice.org Developer's Guide</a> has
+a lot of information, some of it up-to-date.</li>
+<li>Adfinis Sygroup hosts an <a href="http://opengrok.adfinis-sygroup.org/source/">instance of OpenGrok</a> for us which is useful
+for understanding the code.</li>
+<li>We have an <a href="https://fisheye6.atlassian.com/browse/ooo">instance of Altsassian Fisheye</a> which can be useful for browsing the code base and understanding dependencies. (This service is currently broken but we hope to have it back soon).</li>
<li>The <a href="http://openoffice.apache.org/mailing-lists.html#commits-mailing-list">commits mailing list</a> echos every checkin made to the code base. Developers are encouraged to subscribe so they are aware of other changes, and can help review.</li>
</ul>
<h2 id="module-completion">Module Completion</h2>