Title: Developer FAQs
Notice:    Licensed to the Apache Software Foundation (ASF) under one
           or more contributor license agreements.  See the NOTICE file
           distributed with this work for additional information
           regarding copyright ownership.  The ASF licenses this file
           to you under the Apache License, Version 2.0 (the
           "License"); you may not use this file except in compliance
           with the License.  You may obtain a copy of the License at
           .
             http://www.apache.org/licenses/LICENSE-2.0
           .
           Unless required by applicable law or agreed to in writing,
           software distributed under the License is distributed on an
           "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
           KIND, either express or implied.  See the License for the
           specific language governing permissions and limitations
           under the License.

##Developer's Frequently Asked Questions

  - [How do I edit the websites?](#how_do_i_edit_the_websites)
  - [I've just been voted in as a committer what do I need to do?](#ive_just_been_voted_in_as_a_committer__what_do_i_need_to_do)
  - [I'm not a committer, but would like to contribute, what should I do?](#im_not_a_committer)
  - [How do I use Apache Subversion?](#how_do_i_use_apache_subversion)
  - [Where can I find out more about code development?](#where_can_i_find_out_more_about_code_development)
  - [Where can I download developer builds?](#where_can_i_download_developer_builds)


##<a name="how_do_i_edit_the_websites">How do I edit the websites?</a>

The pages on this, the Apache OpenOffice "project", website are written in [markdown syntax][1] and stored in SVN at 
[https://svn.apache.org/repos/asf/incubator/ooo/site][2].

The migrated www.openoffice.org is stored in SVN at [https://svn.apache.org/repos/asf/incubator/ooo/ooo-site][12] and is primarily "html".

Via integration with the [Apache CMS](http://www.apache.org/dev/cms.html), it is possible to edit, stage and publish 
website updates from the command line, or by using a web-based interface, the [CMS bookmarklet](https://cms.apache.org/#bookmark).

Detailed information can be found in the [How to edit the OpenOffice.org website][3] page.

Information on deeper website development is found on the [Website Development][10] page.

##<a name="ive_just_been_voted_in_as_a_committer__what_do_i_need_to_do">I've just been voted in as a Committer.  What do I need to do?</a>

First, congratulations.  Your contributions to the project have been noted and we 
hope that as a Committer you will be even more active.

But before you are officially given Committer permissions, there are a few 
administrative steps that you will need to complete. 

 1. Submit a signed [ICLA] [4] to Apache.
 1. Wait for the ICLA to be received and recorded by Apache.  You will know 
when this has occurred when your name appears in the [Unlisted ICLAs] [5] section 
on the Apache Committers page.  This could take a couple of days, longer if you
submitted the ICLA via post.
 1. Once the your ICLA has been recorded, you should send a note to the [PMC] [6] 
and request an Apache account.  You will want to include your full name and email address, 
as you entered in the ICLA, as well as your preferred userid.  Please [check first] [7] 
that your preferred userid is not already in use by another Apache Committer.
 1. Once your Apache account has been created, you will receive an email with
further instructions for setting up your account.  This may take a couple of days.
 1. If you were also voted as a PMC member, you should then [subscribe] [8] to the 
PMC's private mailing list.

 1. Finally, you should read the ["Guide for new committers"] [9]


##<a name="im_not_a_committer"/>I'm not a committer, but would like to contribute, what should I do? </a>

Apache OpenOffice welcomes your contributions!

If you want to contribute to either of the websites, you can do this by
using subversion and submitting patches via e-mail, or for quick changes, you can use
the [CMS bookmarklet](https://cms.apache.org/#bookmark) and use to edit a page,
and submit a patch as described in the [Apache CMS Reference Manual](http://www.apache.org/dev/cmsref.html#non-committer).
Save your PATCH. File an issue using [OpenOffice Bugzilla](https://issues.apache.org/ooo/) and select the "www"
category to file it. You should then use your saved patch as an attachment to the
issue. Please send a follow-up e-mail to [dev](mailto:dev@openoffice.apache.org) and provide the 
issue number so we can follow-up.

Your contributions will be recognized by the committer submitting the PATCH in the
log entry for the committed patch, and you will be added to the [OpenOffice credits page](http://www.openoffice.org/welcome/credits.html)
to recognize your contribution.

##<a name="how_do_i_use_apache_subversion">How do I use Apache Subversion?</a>

Instructions can be found on the [Subversion Basics] [11] page.

##<a name="where_can_i_find_out_more_about_code_development">Where can I find out more about code development?</a>

You might want to start by reviewing the legacy information on [OpenOffice.org
development](http://www.openoffice.org/development/). Or, take
a look at information posted on the [OpenOffice.org wiki](http://wiki.services.openoffice.org/wiki/Main_Page).

Of course, you will need the [source code](http://openoffice.apache.org/source.html) to do anything.

You don't have to be an actual committer to submit code. You can submit patches through
the Apache OpenOffice Bugzilla issue reporting system. You simply need to file an issue
and supply your patch as an attachment to the issue.


##<a name="where_can_i_download_developer_builds">Where can I download developer builds?</a>

Developer builds are not official releases and may be unstable.  But they can be useful to download for those who 
need early access to builds, but who do not want to compile their own build.

Information on buildbot builds for linux64, window7, and linux32 can be found [here][13].  

Developer builds for the upcoming 3.4 release can be found from:

>[the AOO 3.4 Unofficial Developer Snapshots page](https://cwiki.apache.org/confluence/display/OOOUSERS/AOO+3.4+Unofficial+Developer+Snapshots)


Additionally --

Raphael Bircher posts occasional 
"developer snapshot" builds for other platforms on his [personal website][14].

Ariel Constenla-Haile has posted a set of unofficial, unstable, untested developer builds [here][15].

Also, please see the [Planning Area of the Project Wiki](https://cwiki.apache.org/confluence/display/OOOUSERS/Project+Planning) for
additional information on current and future releases.



  [1]: http://www.simpleeditions.com/59001/markdown-an-introduction
  [2]: https://svn.apache.org/repos/asf/incubator/ooo/site
  [3]: http://openoffice.apache.org/docs/edit-cms.html
  [4]: http://www.apache.org/licenses/icla.txt
  [5]: http://people.apache.org/committer-index.html#unlistedclas
  [6]: mailto:private@openoffice.apache.org
  [7]: http://people.apache.org/committer-index.html
  [8]: mailto:private-subscribe@openoffice.apache.org
  [9]: http://www.apache.org/dev/new-committers-guide.html
  [10]: website-local.html
  [11]: http://openoffice.apache.org/svn-basics.html
  [12]: https://svn.apache.org/repos/asf/incubator/ooo/ooo-site
  [13]: http://ci.apache.org/builders/
  [14]: http://www.raphaelbircher.ch/devsnap.php
  [15]: http://people.apache.org/~arielch/packages/