Author: buildbot
Date: Fri Oct 21 15:40:06 2016
New Revision: 999752
Log:
Staging update by buildbot for openoffice
Modified:
websites/staging/openoffice/trunk/content/ (props changed)
websites/staging/openoffice/trunk/content/orientation/decision-making.html
websites/staging/openoffice/trunk/content/orientation/how-aoo-project-works.html
websites/staging/openoffice/trunk/content/orientation/index.html
websites/staging/openoffice/trunk/content/orientation/infrastructure.html
websites/staging/openoffice/trunk/content/orientation/intro-contributing.html
websites/staging/openoffice/trunk/content/orientation/intro-development.html
websites/staging/openoffice/trunk/content/orientation/intro-doc.html
websites/staging/openoffice/trunk/content/orientation/intro-l10n.html
websites/staging/openoffice/trunk/content/orientation/intro-marketing.html
websites/staging/openoffice/trunk/content/orientation/intro-qa.html
Propchange: websites/staging/openoffice/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri Oct 21 15:40:06 2016
@@ -1 +1 @@
-1766036
+1766050
Modified:
websites/staging/openoffice/trunk/content/orientation/decision-making.html
==============================================================================
--- websites/staging/openoffice/trunk/content/orientation/decision-making.html
(original)
+++ websites/staging/openoffice/trunk/content/orientation/decision-making.html
Fri Oct 21 15:40:06 2016
@@ -120,69 +120,59 @@ h2:hover > .headerlink, h3:hover > .head
visibility: hidden;
}
h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
-<p>In this Orientation Module you will learn about Decision Making within the
project. As with the previous Level 1 Module, if you have prior experience
with an
-open source software project, especially one at Apache, then much of this
material will already be familiar to you.</p>
-<p>In the previous Module we read about collaboration on the mailings lists,
how to do it efficiently and how to avoid the most common pitfalls. We use the
mailing lists for many things,
-for asking questions, for sharing information or the like. But one of the
most important uses of the mailing list is for decision making. It is
important to understand
-how decisions are made in an Apache community. Here are a few general
principles that you should keep in mind:</p>
+<p>In this Orientation Module you will learn about Decision Making within the
project. As with the previous Level 1 Module, if you have prior experience with
an open source software project, especially one at Apache, then much of this
material will already be familiar to you.</p>
+<p>In the previous Module we read about collaboration on the mailings lists,
how to do it efficiently and how to avoid the most common pitfalls. We use the
mailing lists for many things, for asking questions, for sharing information or
the like. But one of the most important uses of the mailing list is for
decision making. It is important to understand how decisions are made in an
Apache community. Here are a few general principles that you should keep in
mind:</p>
<ol>
<li>
-<p>Commit-Then-Review (CTR) and Review-Then-Commit (RTC). </p>
-<p>The two primary ways of managing product changes go by the names
Commit-Then-Review (CTR) and Review-Then-Commit (RTC). For most cases we
operate in a CTR mode,
-meaning that our <a
href="http://www.apache.org/foundation/how-it-works.html#committers";>Committers</a>
are able to check in changes as they desire, with no advance approval or
review.</p>
-<p>We trust our Committers to do the right thing. By default Committers don't
ask permission before acting. They avoid unnecessary discussion and email
traffic. This is not
-because they are anti-social. This is because they realize that in a project
of this size it is impossible to discuss every small change in advance.
Discussing too much is both
-unnecessary and unproductive. We have a "time machine" called Subversion that
allows us to undo any changes to the product or website. So if a Committer
believes that a
-change would be uncontroversial, and the change is reversible, then the
default approach is to go ahead make the change.</p>
+<p>Commit-Then-Review (CTR) and Review-Then-Commit (RTC).</p>
+<p>The two primary ways of managing product changes go by the names
Commit-Then-Review (CTR) and Review-Then-Commit (RTC). For most cases we
operate in a CTR mode, meaning that our <a
href="http://www.apache.org/foundation/how-it-works.html#committers";>Committers</a>
are able to check in changes as they desire, with no advance approval or
review.</p>
+<p>We trust our Committers to do the right thing. By default Committers don't
ask permission before acting. They avoid unnecessary discussion and email
traffic. This is not because they are anti-social. This is because they realize
that in a project of this size it is impossible to discuss every small change
in advance. Discussing too much is both
+unnecessary and unproductive. We have a "time machine" called Subversion that
allows us to undo any changes to the product or website. So if a Committer
believes that a change would be uncontroversial, and the change is
reversible, then the default approach is to go ahead make the change.</p>
<p>Terms that you might need to know related to the above are: <a
href="http://www.urbandictionary.com/define.php?term=JFDI";>JFDI</a> and <a
href=".http://www.apache.org/foundation/glossary.html#LazyConsensus";>"assuming
lazy consensus"</a>.</p>
</li>
<li>
<p>When is RTC, Review-Then-Commit Used?</p>
-<p>There are times where CTR is not appropriate and RTC is used. This
happens, for example, at the end of a release cycle, when we want to carefully
review changes made to the product, in order to control the final quality
before the release. When we're in RTC mode, no changes are made to the code
unless first discussed and approved
-on the mailing list.</p>
+<p>There are times where CTR is not appropriate and RTC is used. This happens,
for example, at the end of a release cycle, when we want to carefully review
changes made to the product, in order to control the final quality before the
release. When we're in RTC mode, no changes are made to the code unless first
discussed and approved on the mailing list.</p>
<p>Other situations when RTC is used instead of CTR might include:</p>
<ol>
<li>
-<p>A Committer is unsure of the technical merits of what they want to do.
-They want an extra pair of eyes to review the proposal point out
-weaknesses, alternatives, etc.</p>
+<p>A Committer is unsure of the technical merits of what they want to do. They
want
+an extra pair of eyes to review the proposal point out weaknesses,
alternatives, etc.</p>
</li>
<li>
-<p>A change is a job for more than one person or requires coordination
-across several subgroups within the project. </p>
+<p>A change is a job for more than one person or requires coordination across
several
+subgroups within the project.</p>
</li>
<li>
-<p>A change to one of our websites that impacts terms and conditions,
-license, copyright, branding, etc. So not a technical change, but a
-substantive change to content in these areas. These require PMC
-review.</p>
+<p>A change to one of our websites that impacts terms and conditions, license,
+copyright, branding, etc. So not a technical change, but a substantive change
to
+content in these areas. These require PMC review.</p>
</li>
<li>
<p>A technical change that breaks backwards compatibility of the product.</p>
</li>
<li>
-<p>Changes that break things. Sometimes this is unavoidable. But it
-should be proposed and coordinated like #2 above.</p>
+<p>Changes that break things. Sometimes this is unavoidable. But it should be
+proposed and coordinated like #2 above.</p>
</li>
<li>
-<p>Changes that cannot easily be reversed. Code changes and most
-website changes are in SVN and can be reverted. But some changes,
-like administrative bulk actions in BZ, cannot be easily undone.</p>
+<p>Changes that cannot easily be reversed. Code changes and most website
changes are
+in SVN and can be reverted. But some changes, like administrative bulk actions
in
+BZ, cannot be easily undone.</p>
</li>
<li>
-<p>Public statements in behalf of the project, e.g., some blog posts
-and announcements, press releases, etc.</p>
+<p>Public statements in behalf of the project, e.g., some blog posts and
+announcements, press releases, etc.</p>
</li>
</ol>
-<p>In all of the above cases, a Proposal detailing the change is sent to the
development list.</p>
+<p>In all of the above cases, a Proposal detailing the change is sent to the
development
+list.</p>
</li>
<li>
<p>Proposals</p>
-<p>The convention is to send all proposals in their own new thread. (Don't
hide a proposal 10 posts deep in an existing thread). Put "[PROPOSAL]" in the
subject line or make it obvious that you are making a proposal.</p>
+<p>The convention is to send all proposals in their own new thread. (Don't
hide a proposal 10 posts deep in an existing thread). Put "[PROPOSAL]" in the
subject line or make it obvious that you are making a proposal.</p>
<p>Because the Volunteers are spread out all across the globe, in various time
zones, and many have day jobs or other committments, the convention is to wait
<em>at least</em> 72 hours for feedback on a proposal.</p>
-<p>In cases where the proposer wants to act on their proposal, if there are no
objections, they should state this in the proposal. For example, "If there are
no objections voiced
- within 72 hours, I'll go ahead and make these changes". This is called
"stating lazy consensus". You can read more about lazy consensus
- <a
href="http://openoffice.apache.org/docs/governance/lazyConsensus.html";>here</a>.</p>
+<p>In cases where the proposer wants to act on their proposal, if there are no
objections, they should state this in the proposal. For example, "If there are
no objections voiced within 72 hours, I'll go ahead and make these changes".
This is called "stating lazy consensus". You can read more about lazy consensus
<a
href="http://openoffice.apache.org/docs/governance/lazyConsensus.html";>here</a>.</p>
</li>
<li>
<p>Voting, Consensus, and Vetoes</p>
@@ -191,29 +181,22 @@ and announcements, press releases, etc.<
<p>In Apache projects it is common to use a shorthand way of responding to
proposals, where +1 indicates approval, 0 indicates indifference and -1
indicates disapproval.</p>
</li>
<li>
-<p>In most cases proposals are decided by consensus, based on community
discussions. Only in rare cases, and in a small number of pre-defined
administrative questions, do we resort
-to a formal counting of votes. The places where we require voting are: voting
to release, voting in a new Committer or PMC Member, Voting in a new PMC Chair.
That's it. Generally
-speaking, voting on any other topic is avoided in favor of consensus building.
With voting there are winners and losers. With consensus everyone wins.</p>
+<p>In most cases proposals are decided by consensus, based on community
discussions. Only in rare cases, and in a small number of pre-defined
administrative questions, do we resort to a formal counting of votes. The
places where we require voting are: voting to release, voting in a new
Committer or PMC Member, Voting in a new PMC Chair. That's it. Generally
speaking, voting on any other topic is avoided in favor of consensus building.
With voting there are winners and losers. With consensus everyone wins.</p>
</li>
<li>
-<p>Another aspect of decision making in an Apache project is the "veto".
Every Committer has the ability to "veto" a change, for technical reasons,
provided he explains
-the technical reasons for the veto, describes an alternative approach, and
offers to help implement the alternative approach. Vetos are quite rare.</p>
+<p>Another aspect of decision making in an Apache project is the "veto". Every
Committer has the ability to "veto" a change, for technical reasons, provided
he explains the technical reasons for the veto, describes an alternative
approach, and offers to help implement the alternative approach. Vetos are
quite rare.</p>
</li>
<li>
-<p>There is one disorder of community decision making that is common enough to
warrant a colorful name: <a href="http://bikeshed.com/";>bikeshedding</a>.
Follow the link and read more
-about this topic.</p>
+<p>There is one disorder of community decision making that is common enough to
warrant a colorful name: <a href="http://bikeshed.com/";>bikeshedding</a>.
Follow the link and read more about this topic.</p>
</li>
</ol>
</li>
<li>
-<p>To apply the above skills, be sure you are subscribed to the project's <a
href="http://openoffice.apache.org/mailing-lists.html#development-mailing-list";>main
mailing list</a>.
-Keep your eye out for terms like "proposal", "lazy consensus", "vote" or
"veto" and see how they are
-used in practice. Compare actual practice to the above descriptions. No,
we're
-not perfect. But we work best and have the most fun when we follow the above
guidelines. And so will
-you when you apply then in your own list communications!</p>
+<p>To apply the above skills, be sure you are subscribed to the project's <a
href="http://openoffice.apache.org/mailing-lists.html#development-mailing-list";>main
mailing list</a>.</p>
</li>
</ol>
-<p>Congratulations, you have completed this Module! </p>
+<p>Keep your eye out for terms like "proposal", "lazy consensus", "vote" or
"veto" and see how they are used in practice. Compare actual practice to the
above descriptions. No, we're not perfect. But we work best and have the most
fun when we follow the above guidelines. And so will you when you apply then in
your own list communications!</p>
+<p>Congratulations, you have completed this Module!</p>
<p>If you have any questions or feedback on this module, please send a note to
<a href="mailto:[email protected]?subject=Comments on Decision
Making Module">[email protected]</a>.</p>
</div>
Modified:
websites/staging/openoffice/trunk/content/orientation/how-aoo-project-works.html
==============================================================================
---
websites/staging/openoffice/trunk/content/orientation/how-aoo-project-works.html
(original)
+++
websites/staging/openoffice/trunk/content/orientation/how-aoo-project-works.html
Fri Oct 21 15:40:06 2016
@@ -125,20 +125,17 @@ h2:hover > .headerlink, h3:hover > .head
<p>Please send an email to <a
href="mailto:[email protected]?subject=Starting How the Apache
OpenOffice Project Works">[email protected]</a> to let us know
you are working on this module.</p>
</li>
<li>
-<p>As you learned in the <a href="intro-contributing.html">previous module</a>
the Apache Software Foundation formally has Members, who elect a Board of
Directors who appoint Officers, including
-PMC (Project Management Committee) Chairs, who work with the PMC's of the
individual Top Level Projects and their communities, to publish open source
software for the public good. In
-this module we'll take a closer look at how exactly we accomplish this within
the Apache OpenOffice project, how we divide up the tasks and get all the stuff
done that is needed to release a new version of
-OpenOffice.</p>
+<p>As you learned in the <a href="intro-contributing.html">previous module</a>
the Apache Software Foundation formally has Members, who elect a Board of
Directors who appoint Officers, including PMC (Project Management Committee)
Chairs, who work with the PMC's of the individual Top Level Projects and their
communities, to publish open source software for the public good. In this
module we'll take a closer look at how exactly we accomplish this within the
Apache OpenOffice project, how we divide up the tasks and get all the stuff
done that is needed to release a new version of OpenOffice.</p>
</li>
<li>
<p>Volunteers in the project tend to self-identify themselves in one or more
of the following categories, depending on their interests, skills and
contributitions:</p>
<ul>
<li>Developers are the programmers who write, debug and fix the C++ code that
is the core of the OpenOffice software.</li>
-<li>QA (Quality Assurance) are the volunteers to test OpenOffice builds,
looking for bugs. They also develop test automation and test cases.</li>
+<li>QA (Quality Assurance) are the volunteers to test OpenOffice builds,
looking for bugs. They also develop test automation and test cases.</li>
<li>Support are the volunteers who answer user questions on our Community
Forums and User list.</li>
<li>UX (Usability)</li>
<li>Localization/Internationalization are the volunteers whose expertise is in
adapting OpenOffice so it works well with the writing and other cultural
conventions and expectations of
-users around the globe. This includes translations and related
activities.</li>
+users around the globe. This includes translations and related activities.</li>
<li>Documentation</li>
<li>Admins, including moderators,</li>
<li>Marketing</li>
@@ -156,8 +153,7 @@ users around the globe. This includes t
</ul>
</li>
<li>
-<p>Congratulations! You have completed this Level. Please send a note to <a
href="mailto:[email protected]?subject=Completed How the Apache
OpenOffice Project Works">[email protected]</a> so
-we all know you have completed this level. This is also a good opportunity
to send along any feedback or questions you might have on this Orientation
Module.</p>
+<p>Congratulations! You have completed this Level. Please send a note to <a
href="mailto:[email protected]?subject=Completed How the Apache
OpenOffice Project Works">[email protected]</a> so we all know
you have completed this level. This is also a good opportunity to send along
any feedback or questions you might have on this Orientation Module.</p>
</li>
</ol>
</div>
Modified: websites/staging/openoffice/trunk/content/orientation/index.html
==============================================================================
--- websites/staging/openoffice/trunk/content/orientation/index.html (original)
+++ websites/staging/openoffice/trunk/content/orientation/index.html Fri Oct 21
15:40:06 2016
@@ -49,7 +49,18 @@
<div id="clear"></div>
<div id="sidenav">
- <h1 id="general">General</h1>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="general">General<a class="headerlink" href="#general" title="Permanent
link">¶</a></h1>
<ul>
<li><a href="/index.html">About</a></li>
<li><a href="/downloads.html">Downloads</a></li>
@@ -58,7 +69,7 @@
<li><a href="/press.html">Press</a></li>
<li><a href="http://www.openoffice.org/";>OpenOffice.org website</a></li>
</ul>
-<h1 id="community">Community</h1>
+<h1 id="community">Community<a class="headerlink" href="#community"
title="Permanent link">¶</a></h1>
<ul>
<li><a href="/get-involved.html">Get Involved</a></li>
<li><a href="/orientation/index.html">Orientation</a></li>
@@ -71,7 +82,7 @@
<li><a href="/people.html">People</a></li>
<li><a href="/community-faqs.html">Community FAQs</a></li>
</ul>
-<h1 id="development">Development</h1>
+<h1 id="development">Development<a class="headerlink" href="#development"
title="Permanent link">¶</a></h1>
<ul>
<li><a href="/source.html">Source Code</a></li>
<li><a href="/bug-tracking.html">Bug Tracking</a></li>
@@ -82,12 +93,12 @@
<li><a href="/contributing-code.html">Contributing Code</a> </li>
<li><a href="/developer-faqs.html">Developer FAQs</a></li>
</ul>
-<h1 id="project-management-pmc">Project Management PMC</h1>
+<h1 id="project-management-pmc">Project Management PMC<a class="headerlink"
href="#project-management-pmc" title="Permanent link">¶</a></h1>
<ul>
<li><a href="http://blogs.apache.org/OOo/";>Project Blog</a></li>
<li><a href="/pmc-faqs.html">PMC FAQs</a> </li>
</ul>
-<h1 id="the-apache-software-foundation">The Apache Software Foundation</h1>
+<h1 id="the-apache-software-foundation">The Apache Software Foundation<a
class="headerlink" href="#the-apache-software-foundation" title="Permanent
link">¶</a></h1>
<ul>
<li><a href="http://www.apache.org/";>Website</a></li>
<li><a href="http://www.openoffice.org/donations.html";>Donations</a></li>
@@ -98,17 +109,24 @@
<div id="contenta">
<h1 class="title">New Volunteer Orientation</h1>
- <h2 id="welcome">Welcome!</h2>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h2 id="welcome">Welcome!<a class="headerlink" href="#welcome"
title="Permanent link">¶</a></h2>
<p>So you are interested in volunteering with the Apache OpenOffice project,
one of the oldest and most famous open source projects around? Great, welcome
to the project!</p>
-<p>Getting involved in a large open source project can be a little
intimidating. There is so much going on, so many new names, new processes, new
ways of communicating. It can be
-confusing, even frustrating at first. In some ways, maybe at the technical
level, it is similar to other software development projects you may be familiar
with. But as a
-community-led open source project the ways we work, communicate, make
decisions, and resolve disputes are very different than what you might see in
other environments.</p>
-<p>In order to help new Volunteers fit into the OpenOffice Community and
understand socially and technically how we work, we have created a set of
self-directed Orientation Modules to
-provide key information and help you develop key skills needed to contribute
effectively to the project.</p>
-<h2 id="four-levels">Four Levels</h2>
+<p>Getting involved in a large open source project can be a little
intimidating. There is so much going on, so many new names, new processes, new
ways of communicating. It can be confusing, even frustrating at first. In some
ways, maybe at the technical level, it is similar to other software development
projects you may be familiar with. But as a community-led open source project
the ways we work, communicate, make decisions, and resolve disputes are very
different than what you might see in other environments.</p>
+<p>In order to help new Volunteers fit into the OpenOffice Community and
understand socially and technically how we work, we have created a set of
self-directed Orientation Modules to provide key information and help you
develop key skills needed to contribute effectively to the project.</p>
+<h2 id="four-levels">Four Levels<a class="headerlink" href="#four-levels"
title="Permanent link">¶</a></h2>
<p>We've designed the Orientation Modules in four levels:</p>
-<p>The first two are focused on general project-wide community participation
skills. These modules provide the information that every contributor should
aim to understand,
-whether they are writing C++ code or user documentation. </p>
+<p>The first two are focused on general project-wide community participation
skills. These modules provide the information that every contributor should aim
to understand, whether they are writing C++ code or user documentation.</p>
<ul>
<li>
<p>Level 1: <a href="intro-contributing.html">Introduction to Contributing to
Apache OpenOffice</a> and <a href="how-aoo-project-works.html">How the Apache
OpenOffice Project Works</a></p>
@@ -117,8 +135,7 @@ whether they are writing C++ code or use
<p>Level 2: <a href="decision-making.html">Decision Making</a> and <a
href="infrastructure.html">Making sense of Project's Technical
Infrastructure</a></p>
</li>
</ul>
-<p>Once you have completed these first two Levels, you will have been exposed
to the basic skills that enable you to volunteer as a general contributor, or
to dive deeper into a
-specialized area of the project, like Quality Assurance, Marketing,
Translation or Development.</p>
+<p>Once you have completed these first two Levels, you will have been exposed
to the basic skills that enable you to volunteer as a general contributor, or
to dive deeper into a specialized area of the project, like Quality Assurance,
Marketing, Translation or Development.</p>
<p>Levels 3 and 4 are specialized Levels, that focus on basic and intermediate
knowledge, processes, tools and skills related to that specific area.</p>
<ul>
<li>
Modified:
websites/staging/openoffice/trunk/content/orientation/infrastructure.html
==============================================================================
--- websites/staging/openoffice/trunk/content/orientation/infrastructure.html
(original)
+++ websites/staging/openoffice/trunk/content/orientation/infrastructure.html
Fri Oct 21 15:40:06 2016
@@ -120,55 +120,34 @@ h2:hover > .headerlink, h3:hover > .head
visibility: hidden;
}
h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
-<p>In this Orientation Module you will learn about tools and servers that are
part of the daily operations of the project. You will interact with many of
these on a regular basis,
-or at least hear them discussed on the lists, so it is important to know what
they are, and where to go if you
-need more information or run into problems.</p>
+<p>In this Orientation Module you will learn about tools and servers that are
part of the daily operations of the project. You will interact with many of
these on a regular basis, or at least hear them discussed on the lists, so it
is important to know what they are, and where to go if you need more
information or run into problems.</p>
<ol>
<li>
-<p>First, Please send an email to <a
href="mailto:[email protected]?subject=Starting Infrastructure
Module">[email protected]</a>
-to let us know you are working on this module.</p>
+<p>First, Please send an email to <a
href="mailto:[email protected]?subject=Starting Infrastructure
Module">[email protected]</a> to let us know you are working on
this module.</p>
</li>
<li>
<p>List of tools and services we use</p>
<ul>
<li>
-<p>ezmlm: This is the time-tested EZ Mailing List Manager application that
manages our mailing lists. You
-control ezmlm by sending commands to a list address. For example, if the list
address is [email protected]
-then you subscribe to the list with the command
dev-<strong>subscribe</strong>@openoffice.apache.org. Some other popular
commands
-are listed <a
href="http://www.apache.org/foundation/mailinglists.html";>here</a>. You can
get a full list of commands
-available to you by sending the <em>help</em> command, as in
dev-<strong>help</strong>@openoffice.apache.org. Each list has moderators
-who have additional capabilities. You can find the moderators for our lists
<a href="http://openoffice.apache.org/pmc-faqs.html#mailing-lists";>here</a>.</p>
-</li>
-<li>
-<p>Our two websites: <a
href="http://www.openoffice.org";>www.openoffice.org</a> and <a
href="http://openoffice.apache.org";>openoffice.apache.org</a>. Why two? There
is some logic here,
-although it is not perfectly executed (yet). The www.openoffice.org website
is our primary user-facing website. It is where we put content intended for
end-users
-to use, so downloads, product documentations, support and other related
materials. The openoffice.apache.org website, on the other hand, is the main
portal for
-project members, the contributors to the project. We run the project on
openoffice.apache.org, and the www.openoffice.org website is a service we
provide to users.</p>
-</li>
-<li>
-<p>MediaWiki (also called MWiki) is used for the wiki on the <a
href="http://wiki.openoffice.org/wiki/Main_Page";>wiki.openoffice.org</a>
website.
-We use MWiki for many of the user-facing pages on the website, especially in
the areas of documentation and support. If you are familiar with Wikipedia and
-the syntax used for authoring articles there, then you will find our MediaWiki
very easy to use, since Wikipedia
-also uses MediaWiki. If you are new to MediaWiki please read over this <a
href="http://meta.wikimedia.org/wiki/Help:Editing";>introduction to the
basics</a>.</p>
+<p>ezmlm: This is the time-tested EZ Mailing List Manager application that
manages our mailing lists. You control ezmlm by sending commands to a list
address. For example, if the list address is [email protected] then
you subscribe to the list with the command
dev-<strong>subscribe</strong>@openoffice.apache.org. Some other popular
commands are listed <a
href="http://www.apache.org/foundation/mailinglists.html";>here</a>. You can get
a full list of commands available to you by sending the <em>help</em> command,
as in dev-<strong>help</strong>@openoffice.apache.org. Each list has moderators
who have additional capabilities. You can find the moderators for our lists <a
href="http://openoffice.apache.org/pmc-faqs.html#mailing-lists";>here</a>.</p>
+</li>
+<li>
+<p>Our two websites: <a
href="http://www.openoffice.org";>www.openoffice.org</a> and <a
href="http://openoffice.apache.org";>openoffice.apache.org</a>. Why two? There
is some logic here, although it is not perfectly executed (yet). The
www.openoffice.org website is our primary user-facing website. It is where we
put content intended for end-users to use, so downloads, product
documentations, support and other related materials. The openoffice.apache.org
website, on the other hand, is the main portal for project members, the
contributors to the project. We run the project on openoffice.apache.org, and
the www.openoffice.org website is a service we provide to users.</p>
+</li>
+<li>
+<p>MediaWiki (also called MWiki) is used for the wiki on the <a
href="http://wiki.openoffice.org/wiki/Main_Page";>wiki.openoffice.org</a>
website. We use MWiki for many of the user-facing pages on the website,
especially in the areas of documentation and support. If you are familiar with
Wikipedia and the syntax used for authoring articles there, then you will find
our MediaWiki very easy to use, since Wikipedia also uses MediaWiki. If you are
new to MediaWiki please read over this <a
href="http://meta.wikimedia.org/wiki/Help:Editing";>introduction to the
basics</a>.</p>
</li>
<li>
<p>Confluence Wiki (also called CWiki) is used for some <a
href="https://cwiki.apache.org/confluence/display/OOOUSERS/Wiki+Home";>project
management webpages</a></p>
</li>
<li>
-<p><a href="http://translate.apache.org";>Pootle</a> is our translation
management server, an online service used by translators to translate the UI
-and help files of OpenOffice into various languages. Unless you are involved
with translations or builds you probably will never use Pootle. But you will
hear
-it mentioned on the mailing lists.</p>
+<p><a href="http://translate.apache.org";>Pootle</a> is our translation
management server, an online service used by translators to translate the UI
and help files of OpenOffice into various languages. Unless you are involved
with translations or builds you probably will never use Pootle. But you will
hear it mentioned on the mailing lists.</p>
</li>
<li>
-<p>Apache CMS (Content Management System) is the software that manages our
websites, including the application of side-wide templates used to apply, for
example,
-the common page footers that occur on each page). There is a web interface
to the Apache CMS that makes it easy to make small updates to a page. If you
are interested
-in adding or editing the website you can watch this video on the <a
href="http://www.youtube.com/watch?v=7fvg1pfHLhE";>Apache CMS's Anonymous
Mode</a> now. Otherwise
-this is a valuable skill you can pick up later.</p>
+<p>Apache CMS (Content Management System) is the software that manages our
websites, including the application of side-wide templates used to apply, for
example, the common page footers that occur on each page). There is a web
interface to the Apache CMS that makes it easy to make small updates to a page.
If you are interested in adding or editing the website you can watch this video
on the <a href="http://www.youtube.com/watch?v=7fvg1pfHLhE";>Apache CMS's
Anonymous Mode</a> now. Otherwise this is a valuable skill you can pick up
later.</p>
</li>
<li>
-<p>Subversion is the Version Control System (VCS) used by the project.
Subversion is also its own Apache project. The source code for the OpenOffice
product as well as
-the files for the websites are all stored in Subversion. Developers use
Subversion heavily in their work. Advanced work in QA and bulk website changes
also involve using
-Subversion.</p>
+<p>Subversion is the Version Control System (VCS) used by the project.
Subversion is also its own Apache project. The source code for the OpenOffice
product as well as the files for the websites are all stored in Subversion.
Developers use Subversion heavily in their work. Advanced work in QA and bulk
website changes also involve using Subversion.</p>
</li>
<li>
<p>phpBB is the software that runs our <a
href="http://forum.openoffice.org/en/forum/";>Community Forums</a>, used for
technical support of our users.</p>
@@ -177,32 +156,23 @@ Subversion.</p>
<p><a href="https://issues.apache.org/ooo/";>Bugzilla</a> is used to track
defect OpenOffice (bug) report.</p>
</li>
<li>
-<p><a href="https://issues.apache.org/jira/";>JIRA</a> is another issue
tracking application. Some Apache projects use JIRA instead of Bugzilla. We
mainly use JIRA when we
-need to raise an issue with another group at Apache that uses JIRA, for
example the Apache Infrastructure Team.</p>
+<p><a href="https://issues.apache.org/jira/";>JIRA</a> is another issue
tracking application. Some Apache projects use JIRA instead of Bugzilla. We
mainly use JIRA when we need to raise an issue with another group at Apache
that uses JIRA, for example the Apache Infrastructure Team.</p>
</li>
</ul>
</li>
<li>
-<p>It is important to understand the role of the <a
href="http://www.apache.org/dev/infrastructure.html";>Apache Infrastructure
Team</a>
-(Infra or Infra@. The Infrastructure team are essentially the system
administrators for all Apache-wide servers and services,
-including many of the services described above. As you can imagine, with all
the projects that are part of Apache, this is huge job.<br />
-In order to support this number of projects and provide good service levels in
this shared infrastructure environment, we align ourselves
-with the common services that are made available to other projects. In other
words, we have a "menu" of services that we can enable for the project,
-and the ability to do some customization, within defined bounds, but we cannot
easily use a service outside of that menu. </p>
+<p>It is important to understand the role of the <a
href="http://www.apache.org/dev/infrastructure.html";>Apache Infrastructure
Team</a> (Infra or Infra@. The Infrastructure team are essentially the system
administrators for all Apache-wide servers and services, including many of the
services described above. As you can imagine, with all the projects that are
part of Apache, this is huge job. In order to support this number of projects
and provide good service levels in this shared infrastructure environment, we
align ourselves with the common services that are made available to other
projects. In other words, we have a "menu" of services that we can enable for
the project, and the ability to do some customization, within defined bounds,
but we cannot easily use a service outside of that menu.</p>
</li>
<li>
<p>What to do if you have a problem:</p>
<ul>
-<li>Questions on how to use the service: First, look for intructions on the
website. If that fails, post a note to the dev mailing list for hints.</li>
-<li>Outages: <a href="http://monitoring.apache.org/status/";>Current status</a>
is posted. You might also want to subscribe to Infra's <a
href="https://twitter.com/infrabot";>Twitter feed</a>.
-If you see an outage not noted there already, you can notify Infra via IRC
channel #asfinfra on Freenode.</li>
-<li>Requests to enhance or modify the service: Propose something on dev. Even
though Infra is required to carry out some tasks, you still should get
consensus
-first on the project's mailing list.</li>
+<li>Questions on how to use the service: First, look for intructions on the
website. If that fails, post a note to the dev mailing list for hints.</li>
+<li>Outages: <a href="http://monitoring.apache.org/status/";>Current status</a>
is posted. You might also want to subscribe to Infra's <a
href="https://twitter.com/infrabot";>Twitter feed</a>. If you see an outage not
noted there already, you can notify Infra via IRC channel #asfinfra on
Freenode.</li>
+<li>Requests to enhance or modify the service: Propose something on dev. Even
though Infra is required to carry out some tasks, you still should get
consensus first on the project's mailing list.</li>
</ul>
</li>
<li>
-<p>Congratulations! You have completed this Module. Please send a note to <a
href="mailto:[email protected]?subject=Completed Infrastructure
Module">[email protected]</a> so
-we all know you have completed this level. This is also a good opportunity
to send along any feedback or questions you might have on this Orientation
Module.</p>
+<p>Congratulations! You have completed this Module. Please send a note to <a
href="mailto:[email protected]?subject=Completed Infrastructure
Module">[email protected]</a> so we all know you have completed
this level. This is also a good opportunity to send along any feedback or
questions you might have on this Orientation Module.</p>
</li>
</ol>
</div>
Modified:
websites/staging/openoffice/trunk/content/orientation/intro-contributing.html
==============================================================================
---
websites/staging/openoffice/trunk/content/orientation/intro-contributing.html
(original)
+++
websites/staging/openoffice/trunk/content/orientation/intro-contributing.html
Fri Oct 21 15:40:06 2016
@@ -120,24 +120,16 @@ h2:hover > .headerlink, h3:hover > .head
visibility: hidden;
}
h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
-<p>In this Orientation Module you will gain basic familiarity with the Apache
Software Foundation and how it works,
-get signed up for various important online project services, and introduce
yourself to the other volunteers on
-the project's mailing mailing list. </p>
+<p>In this Orientation Module you will gain basic familiarity with the Apache
Software Foundation and how it works, get signed up for various important
online project services, and introduce yourself to the other volunteers on the
project's mailing mailing list.</p>
<p>Level 1 is focused on connecting you to the project.</p>
<p>If you have prior experience with an open source software project,
especially one at
Apache, then much of this will already be familiar to you.</p>
<ol>
<li>
-<p>Introduce yourself to the other project Volunteers by sending an email to
<a href="mailto:[email protected]?subject=Starting Introduction
to Contributing to Apache OpenOffice
Module">[email protected]</a>. Who are you, where
-are you from, what are you interested in? These are all good things to cover.
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 list.</p>
+<p>Introduce yourself to the other project Volunteers by sending an email to
<a href="mailto:[email protected]?subject=Starting Introduction
to Contributing to Apache OpenOffice
Module">[email protected]</a>. Who are you, where are you from,
what are you interested in? These are all good things to cover. 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 list.</p>
</li>
<li>
-<p>It is important that you understand a little about the Apache Software
Foundation and OpenOffice,
-what it is, how it is organized and how the Apache OpenOffice Project fits
into the overall Foundation. This is partially
-organizational knowledge and a little history. But it is important for
understanding how things work here,
-and understanding the culture of this open source community. Suggested
readings are:</p>
+<p>It is important that you understand a little about the Apache Software
Foundation and OpenOffice, what it is, how it is organized and how the Apache
OpenOffice Project fits into the overall Foundation. This is partially
organizational knowledge and a little history. But it is important for
understanding how things work here, and understanding the culture of this open
source community. Suggested readings are:</p>
<ol>
<li><a href="http://apache.org/foundation/how-it-works.html";>How It Works</a>
(to learn about how the ASF is organized and how its meritocracy works)</li>
<li><a href="http://www.apache.org/foundation/faq.html";>ASF FAQ's</a> (browse
to see if it answers any questions you might have)</li>
@@ -146,64 +138,40 @@ and understanding the culture of this op
</ol>
</li>
<li>
-<p>As a globally-distributed all-volunteer open source project, there is never
a time or place where we can
-all meet together in the same room or even on a telephone call. Because of
this, and out of respect for
-everyone's busy and varying schedule, we use mailing lists to coordinate our
work, make proposals, gather
-consensus and resolve community issues. There are three mailing lists that
every Volunteer should be on:</p>
+<p>As a globally-distributed all-volunteer open source project, there is never
a time or place where we can all meet together in the same room or even on a
telephone call. Because of this, and out of respect for everyone's busy and
varying schedule, we use mailing lists to coordinate our work, make proposals,
gather consensus and resolve community issues. There are three mailing lists
that every Volunteer should be on:</p>
<ol>
-<li><a
href="http://openoffice.apache.org/mailing-lists.html#development-mailing-list";>dev</a>
This is the
-main mailing list for the project, and gets a lot of traffic. But this is
where project-wide discussions occur.</li>
-<li><a
href="http://openoffice.apache.org/mailing-lists.html#announce-mailing-list";>announce</a>
This
-is the official announcement list for the project. It is used for announcing
things like new releases,
-security patches, conferences, etc.</li>
-<li><a
href="http://openoffice.apache.org/mailing-lists.html#users-mailing-list";>users</a>
This is our users
-list and is one way in which we provide support to end users. Although you
may not be interested specifically
-in user support, it is still recommended that you follow this list, even if
just to get a feel for
-user concerns, problems, feature ideas, etc.</li>
+<li><a
href="http://openoffice.apache.org/mailing-lists.html#development-mailing-list";>dev</a>
This is the main mailing list for the project, and gets a lot of traffic. But
this is where project-wide discussions occur.</li>
+<li><a
href="http://openoffice.apache.org/mailing-lists.html#announce-mailing-list";>announce</a>
This is the official announcement list for the project. It is used for
announcing things like new releases, security patches, conferences, etc.</li>
+<li><a
href="http://openoffice.apache.org/mailing-lists.html#users-mailing-list";>users</a>
This is our users list and is one way in which we provide support to end
users. Although you may not be interested specifically in user support, it is
still recommended that you follow this list, even if just to get a feel for
user concerns, problems, feature ideas, etc.</li>
</ol>
</li>
<li>
-<p>You can also review other mailing lists we host and which may be of
interest, including ones focused on
-specific <a href="http://openoffice.apache.org/mailing-lists.html";>project
functions</a> and
-<a href="http://openoffice.apache.org/native-lang.html";>native
languages</a>.</p>
+<p>You can also review other mailing lists we host and which may be of
interest, including ones focused on specific <a
href="http://openoffice.apache.org/mailing-lists.html";>project functions</a>
and <a href="http://openoffice.apache.org/native-lang.html";>native
languages</a>.</p>
</li>
<li>
-<p>A useful shortcut notation you will often see on the lists. Writing a list
name in full, like [email protected] can be tedious. So you will
often see
-it called just "dev@". Similarly, top-level lists like [email protected]
are often referred to as "trademarks@". This shortcut can be used to refer
-either to the mailing list and to the team that operates the mailing list.
The context should make it clear, e.g., "You should check with trademarks@ on
whether this will be problem".</p>
+<p>A useful shortcut notation you will often see on the lists. Writing a list
name in full, like [email protected] can be tedious. So you will often
see it called just "dev@". Similarly, top-level lists like
[email protected] are often referred to as "trademarks@". This shortcut can
be used to refer either to the mailing list and to the team that operates the
mailing list. The context should make it clear, e.g., "You should check with
trademarks@ on whether this will be problem".</p>
</li>
<li>
-<p>One of the first practical tests each Volunteer faces is dealing with the
volume of emails that comes from
-participation in an open source project like this. A good email client for
this kind of work will support
-folders, rule-based folder assignments, and most importantly quote collapsing.
A common practice is to make
-a separate folder for each Apache mailing list and define a rule to move
incoming emails directly into that folder.
-If you have a question on how to configure your email client to do these
things, try your help files,
-or a web search first, and if that fails post a question to the dev list.</p>
+<p>One of the first practical tests each Volunteer faces is dealing with the
volume of emails that comes from participation in an open source project like
this. A good email client for this kind of work will support folders,
rule-based folder assignments, and most importantly quote collapsing. A common
practice is to make a separate folder for each Apache mailing list and define a
rule to move incoming emails directly into that folder. If you have a question
on how to configure your email client to do these things, try your help files,
or a web search first, and if that fails post a question to the dev list.</p>
</li>
<li>
-<p>Because our mailing lists can be busy, and we're not all native English
speakers, and because email text is
-a crude medium which makes it hard to express nuanced emotions, we need to be
careful and tolerant in how we
-use it. Please read over our <a
href="http://openoffice.apache.org/mailing-lists.html#participation-guidelines";>Participation
Guidelines</a>
-and <a href="http://openoffice.apache.org/list-conduct.html";>List Conduct
Guidelines</a> for more information.</p>
+<p>Because our mailing lists can be busy, and we're not all native English
speakers, and because email text is a crude medium which makes it hard to
express nuanced emotions, we need to be careful and tolerant in how we use it.
Please read over our <a
href="http://openoffice.apache.org/mailing-lists.html#participation-guidelines";>Participation
Guidelines</a> and <a
href="http://openoffice.apache.org/list-conduct.html";>List Conduct
Guidelines</a> for more information.</p>
</li>
<li>
-<p>From Karl Fogel's book <a href="http://producingoss.com/";>"Producing Open
Source Software"</a> read through
-<a
href="http://producingoss.com/en/communications.html#you-are-what-you-write";>"You
Are What You Write"</a> and <a
href="http://producingoss.com/en/common-pitfalls.html";>"Avoiding Common
Pitfalls"</a>.</p>
+<p>From Karl Fogel's book <a href="http://producingoss.com/";>"Producing Open
Source Software"</a> read through <a
href="http://producingoss.com/en/communications.html#you-are-what-you-write";>"You
Are What You Write"</a> and <a
href="http://producingoss.com/en/common-pitfalls.html";>"Avoiding Common
Pitfalls"</a>.</p>
</li>
<li>
<p>Aside from the mailing lists there are several online services that every
volunteer should be signed up for:</p>
<ol>
<li>Our <a href="http://wiki.openoffice.org/wiki/Main_Page";>MediaWiki</a>
(sometimes called MWiki) used for user documentation and many other things.</li>
<li>Our <a
href="https://cwiki.apache.org/confluence/display/OOOUSERS/Wiki+Home";>ConfluenceWiki</a>
(sometimes called CWiki) where we do project planning.</li>
-<li>Our <a href="https://bz.apache.org/ooo/";>Bugzilla database</a> (sometimes
called BZ) where we report and track status on bugs.</li>
-<li>Our <a href="http://forum.openoffice.org/";>Community Forums</a> These are
available in several languages. This is the primary way in which we engage
with the user community.</li>
+<li>Our <a href="https://bz.apache.org/ooo/";>Bugzilla database</a> (sometimes
called BZ) where we report and track status on bugs.</li>
+<li>Our <a href="http://forum.openoffice.org/";>Community Forums</a> These are
available in several languages. This is the primary way in which we engage with
the user community.</li>
<li>Join our <a href="http://openoffice.apache.org/social.html";>Social
Networks</a></li>
</ol>
</li>
<li>
-<p>Finally, once you have done the above, go to our our <a
href="https://cwiki.apache.org/confluence/display/OOOUSERS/Directory+of+Volunteers";>Directory
of Volunteers</a> wiki page and add your
-information. Congratulations! Please send a note to <a
href="mailto:[email protected]?subject=Completed Introduction
to Contributing to Apache OpenOffice
Module">[email protected]</a>
-so we know.</p>
+<p>Finally, once you have done the above, go to our our <a
href="https://cwiki.apache.org/confluence/display/OOOUSERS/Directory+of+Volunteers";>Directory
of Volunteers</a> wiki page and add your information. Congratulations! Please
send a note to <a
href="mailto:[email protected]?subject=Completed Introduction
to Contributing to Apache OpenOffice
Module">[email protected]</a> so we know.</p>
</li>
</ol>
</div>
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
Fri Oct 21 15:40:06 2016
@@ -121,81 +121,53 @@ h2:hover > .headerlink, h3:hover > .head
}
h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
<h2 id="introduction">Introduction<a class="headerlink" href="#introduction"
title="Permanent link">¶</a></h2>
-<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 Recruitment mailing list. You can
subscribe by sending an email to
-<a
href="mailto:[email protected]";>[email protected]</a>.
</p>
-<p>Then you can introduce yourself by <a
href="mailto:[email protected]?subject=New Dev
Volunteer">sending an email to the list</a>.
-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 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>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 Recruitment mailing list. You can
subscribe by sending an email to <a
href="mailto:[email protected]";>[email protected]</a>.</p>
+<p>Then you can introduce yourself by <a
href="mailto:[email protected]?subject=New Dev
Volunteer">sending an email to the list</a>. 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 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<a class="headerlink"
href="#openoffice-development-good-the-bad-and-the-ugly" title="Permanent
link">¶</a></h2>
-<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 depend on
OpenOffice,
-with another million downloads every week, downloads from almost every country
in the world. So the work you do, the bugs you fix,
-the features you add, will benefit millions of users around the world.</p>
+<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 depend on OpenOffice,
with another million downloads every week, downloads from almost every country
in the world. 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<a class="headerlink"
href="#building-openoffice" title="Permanent link">¶</a></h2>
-<p>It all starts by establishing 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>It all starts by establishing a local build environment. Building
OpenOffice on Linux or Mac is relatively easy, but expect the first attempt to
require some trial and error. very 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_AOO";>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 known problem with a known solution.</p>
-<p>Note also 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>.
+<p>Our <a
href="http://wiki.openoffice.org/wiki/Documentation/Building_Guide_AOO";>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 known problem with a known solution.</p>
+<p>Note also 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:[email protected]?subject=Successful 1st Build!">post a
note to the dev list</a> for some well-earned congratulations!</p>
<h2 id="orienting-yourself">Orienting Yourself<a class="headerlink"
href="#orienting-yourself" title="Permanent link">¶</a></h2>
<p>A few suggestions to help you find your way around this massive
codebase:</p>
<ul>
<li>An explanation of the purpose/function of the various <a
href="http://wiki.openoffice.org/wiki/Source_code_directories";>source
directories</a></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>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
Atlassian Fisheye</a> which can be useful for browsing the code base and
understanding dependencies.</li>
</ul>
<h2 id="finding-easy-tasks">Finding Easy Tasks<a class="headerlink"
href="#finding-easy-tasks" title="Permanent link">¶</a></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 volunteers 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?f1=cf_fix_difficulty&o1=equals&resolution=---&query_format=advanced&v1=easy&list_id=42478";>easy-hacks</a>
and <a
href="https://issues.apache.org/ooo/buglist.cgi?f1=cf_fix_difficulty&o1=equals&resolution=---&query_format=advanced&v1=simple&list_id=42478";>simple-hacks</a>
queries.</p>
-<p>Once 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. </p>
+<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
volunteers 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?f1=cf_fix_difficulty&o1=equals&resolution=---&query_format=advanced&v1=easy&list_id=42478";>easy-hacks</a>
and <a
href="https://issues.apache.org/ooo/buglist.cgi?f1=cf_fix_difficulty&o1=equals&resolution=---&query_format=advanced&v1=simple&list_id=42478";>simple-hacks</a>
queries.</p>
+<p>Once 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.</p>
<h2 id="coding-standards">Coding Standards<a class="headerlink"
href="#coding-standards" title="Permanent link">¶</a></h2>
<p>For reference note the following coding standards for the project:</p>
<ul>
<li><a href="http://wiki.openoffice.org/wiki/Coding_Standards";>Coding
Standards</a></li>
<li><a
href="http://wiki.openoffice.org/wiki/Writer/Code_Conventions";>Writer/Code
Conventions</a></li>
</ul>
-<p>The Geneva Convention prevents us from forcing you to read all of those
rules, but know that they are there, and
-when your code is reviewed your reviewer might refer to some of those rules if
there is an issue. So you'll
-absorb them over time.</p>
+<p>The Geneva Convention prevents us from forcing you to read all of those
rules, but know that they are there, and when your code is reviewed your
reviewer might refer to some of those rules if there is an issue. So you'll
absorb them over time.</p>
<h2 id="submitting-patches">Submitting Patches<a class="headerlink"
href="#submitting-patches" title="Permanent link">¶</a></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 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>
+<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<a class="headerlink"
href="#other-useful-resources" title="Permanent link">¶</a></h2>
<ul>
-<li>The <a href="http://www.openoffice.org/development/";>OpenOffice.org for
Developers</a> web area has
-useful information for getting started.</li>
-<li>The <a href="https://wiki.openoffice.org/wiki/Development";>OpenOffice.org
Development Wiki Area</a> has
-a lot of good general development information.</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>
+<li>The <a href="http://www.openoffice.org/development/";>OpenOffice.org for
Developers</a> web area has useful information for getting started.</li>
+<li>The <a href="https://wiki.openoffice.org/wiki/Development";>OpenOffice.org
Development Wiki Area</a> has a lot of good general development
information.</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<a class="headerlink"
href="#module-completion" title="Permanent link">¶</a></h2>
-<p>Once you have completed this module, go to our our <a
href="https://cwiki.apache.org/confluence/display/OOOUSERS/Directory+of+Volunteers";>Directory
of Volunteers</a> wiki page and add or update
-your information. Congratulations! Please send a note to <a
href="mailto:[email protected]?subject=Completed Introduction
to Development">[email protected]</a> so we know.</p>
+<p>Once you have completed this module, go to our our <a
href="https://cwiki.apache.org/confluence/display/OOOUSERS/Directory+of+Volunteers";>Directory
of Volunteers</a> wiki page and add or update your information.
Congratulations! Please send a note to <a
href="mailto:[email protected]?subject=Completed Introduction
to Development">[email protected]</a> so we know.</p>
</div>
<div id="footera">
Modified: websites/staging/openoffice/trunk/content/orientation/intro-doc.html
==============================================================================
--- websites/staging/openoffice/trunk/content/orientation/intro-doc.html
(original)
+++ websites/staging/openoffice/trunk/content/orientation/intro-doc.html Fri
Oct 21 15:40:06 2016
@@ -49,7 +49,18 @@
<div id="clear"></div>
<div id="sidenav">
- <h1 id="general">General</h1>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="general">General<a class="headerlink" href="#general" title="Permanent
link">¶</a></h1>
<ul>
<li><a href="/index.html">About</a></li>
<li><a href="/downloads.html">Downloads</a></li>
@@ -58,7 +69,7 @@
<li><a href="/press.html">Press</a></li>
<li><a href="http://www.openoffice.org/";>OpenOffice.org website</a></li>
</ul>
-<h1 id="community">Community</h1>
+<h1 id="community">Community<a class="headerlink" href="#community"
title="Permanent link">¶</a></h1>
<ul>
<li><a href="/get-involved.html">Get Involved</a></li>
<li><a href="/orientation/index.html">Orientation</a></li>
@@ -71,7 +82,7 @@
<li><a href="/people.html">People</a></li>
<li><a href="/community-faqs.html">Community FAQs</a></li>
</ul>
-<h1 id="development">Development</h1>
+<h1 id="development">Development<a class="headerlink" href="#development"
title="Permanent link">¶</a></h1>
<ul>
<li><a href="/source.html">Source Code</a></li>
<li><a href="/bug-tracking.html">Bug Tracking</a></li>
@@ -82,12 +93,12 @@
<li><a href="/contributing-code.html">Contributing Code</a> </li>
<li><a href="/developer-faqs.html">Developer FAQs</a></li>
</ul>
-<h1 id="project-management-pmc">Project Management PMC</h1>
+<h1 id="project-management-pmc">Project Management PMC<a class="headerlink"
href="#project-management-pmc" title="Permanent link">¶</a></h1>
<ul>
<li><a href="http://blogs.apache.org/OOo/";>Project Blog</a></li>
<li><a href="/pmc-faqs.html">PMC FAQs</a> </li>
</ul>
-<h1 id="the-apache-software-foundation">The Apache Software Foundation</h1>
+<h1 id="the-apache-software-foundation">The Apache Software Foundation<a
class="headerlink" href="#the-apache-software-foundation" title="Permanent
link">¶</a></h1>
<ul>
<li><a href="http://www.apache.org/";>Website</a></li>
<li><a href="http://www.openoffice.org/donations.html";>Donations</a></li>
@@ -98,23 +109,26 @@
<div id="contenta">
<h1 class="title">Introduction to Documentation</h1>
- <h2 id="introduction">Introduction</h2>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h2 id="introduction">Introduction<a class="headerlink" href="#introduction"
title="Permanent link">¶</a></h2>
<p>In this orientation module you will learn how to get started in the
OpenOffice Documentation Team.</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 wiki.</p>
-<p>Your first task is to subscribe to our Documentation mailing list. You can
subscribe by sending an email to
-<a
href="mailto:[email protected]";>[email protected]</a>.
</p>
-<p>Then you can introduce yourself by <a
href="mailto:[email protected]?subject=New%20Doc%20Volunteer";>sending
an email to the list</a>.
-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 Doc-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>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 wiki.</p>
+<p>Your first task is to subscribe to our Documentation mailing list. You can
subscribe by sending an email to <a
href="mailto:[email protected]";>[email protected]</a>.</p>
+<p>Then you can introduce yourself by <a
href="mailto:[email protected]?subject=New Doc Volunteer">sending an
email to the list</a>. 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 Doc-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="the-big-picture">The Big Picture</h2>
-<p>As a popular end-user facing product, Apache OpenOffice is used by millions
of people around the world, with a wide range of skills and backgrounds. Some
have been using OpenOffice for
-a decade. Others are just moving over from Microsoft Office. Some are very
familiar with computers and their operating systems. Others may be using a
computer for the first time. Some
-are doing just basic editing. Others are "power users" and are creating
complex applications built on top of OpenOffice.</p>
+<h2 id="the-big-picture">The Big Picture<a class="headerlink"
href="#the-big-picture" title="Permanent link">¶</a></h2>
+<p>As a popular end-user facing product, Apache OpenOffice is used by millions
of people around the world, with a wide range of skills and backgrounds. Some
have been using OpenOffice for a decade. Others are just moving over from
Microsoft Office. Some are very familiar with computers and their operating
systems. Others may be using a computer for the first time. Some are doing just
basic editing. Others are "power users" and are creating complex applications
built on top of OpenOffice.</p>
<p>When users have a question, when they get stuck, there are a wide range of
options for them:</p>
<ul>
<li>They might ask a friend for help</li>
@@ -123,34 +137,25 @@ are doing just basic editing. Others are
<li>They might post a question to our <a
href="http://forum.openoffice.org";>community support forum</a></li>
<li>They might go to the <a href="http://www.openoffice.org";>OpenOffice.org
website</a> and look for a solution there</li>
</ul>
-<p>The documentation we write aids both the end-users as well as those who
support the end users. We aim to provide authoritative, up-to-date material
for Apache OpenOffice, and to aid
-users of all skill levels. If we do our tasks well, users are more satisfied
and more productive.</p>
-<h2 id="varieties-of-documentation">Varieties of Documentation</h2>
+<p>The documentation we write aids both the end-users as well as those who
support the end users. We aim to provide authoritative, up-to-date material for
Apache OpenOffice, and to aid users of all skill levels. If we do our tasks
well, users are more satisfied and more productive.</p>
+<h2 id="varieties-of-documentation">Varieties of Documentation<a
class="headerlink" href="#varieties-of-documentation" title="Permanent
link">¶</a></h2>
<p>We maintain documentation in a variety of forms:</p>
<ul>
-<li>Built-in help files that are included in the product installs. These are
context-sensitive help files that you get when you press "F1" in an OpenOffice
application.</li>
-<li>User Guides that are available on the website. These include a mixture of
overview and task-specific topics.</li>
+<li>Built-in help files that are included in the product installs. These are
context-sensitive help files that you get when you press "F1" in an OpenOffice
application.</li>
+<li>User Guides that are available on the website. These include a mixture of
overview and task-specific topics.</li>
<li>Special topics, such as migration guides, scripting cookbooks, etc.</li>
</ul>
<p>All OpenOffice documentation is housed on the <a
href="https://wiki.openoffice.org/wiki/Documentation";>OpenOffice wiki</a> for
ease of maintenance by volunteers with the exception of the help files which
are integrated with the OpenOffice product itself.</p>
-<h2 id="goals-and-constraints">Goals and Constraints</h2>
+<h2 id="goals-and-constraints">Goals and Constraints<a class="headerlink"
href="#goals-and-constraints" title="Permanent link">¶</a></h2>
<p>In our documentation work we need to be aware of the following goals and
constraints:</p>
<ul>
-<li>Only around 1/3 of OpenOffice users speak English as their native
language. This is true also of the volunteers working on documentation. So in
our list conversations, and in our
- documentation, we should aim for good, simple English prose, avoiding
regional idioms and jargon. By convention we're adopting U.S. English spelling
for the documentation.
- So we should plan for the documentation we write to be translated at some
point.</li>
-<li>We should also write the documentation so it can be translated into other
languages. This means we need to be careful about how we mix text and graphics
together in any diagrams.</li>
-<li>We use the <a
href="http://www.apache.org/licenses/LICENSE-2.0.html";>Apache License 2.0</a>
for all project deliverables. This "permissive" open source license ensures
that everyone has the
- ability to adapt and reuse the documentation that we create. But it also
means that we need to be careful about what other 3rd party material we use in
our documentation. Until you
- are familiar with the Apache rules for using 3rd party material into an
Apache product, you should start a discussion on the mailing list for any 3rd
party material you want to reuse.
- This includes material from the legacy OpenOffice.org project as well, since
some of that was under a different license.</li>
-<li>We're aiming to provide as much content as possible in the form of MWiki
pages. These are easy for users to access, from any device. Also, since they
are indexed by search engines
- they will be easy to find for the users who like to resolve issues by
searching Google for solutions.</li>
-</ul>
-<h2 id="volunteers-are-welcome">Volunteers are Welcome</h2>
-<p>We're looking for volunteers with technical writing experience, a good
working knowledge of OpenOffice, or ideally both. The ability to collaborate
with others in written English
-on the mailing list is required, but you just need to be understandable. For
the actual writing, we have editor volunteers who will review and edit the
rough drafts to fix any
-language errors. So you don't need to have native-level English skills.</p>
+<li>Only around 1/3 of OpenOffice users speak English as their native
language. This is true also of the volunteers working on documentation. So in
our list conversations, and in our documentation, we should aim for good,
simple English prose, avoiding regional idioms and jargon. By convention we're
adopting U.S. English spelling for the documentation. So we should plan for the
documentation we write to be translated at some point.</li>
+<li>We should also write the documentation so it can be translated into other
languages. This means we need to be careful about how we mix text and graphics
together in any diagrams.</li>
+<li>We use the <a
href="http://www.apache.org/licenses/LICENSE-2.0.html";>Apache License 2.0</a>
for all project deliverables. This "permissive" open source license ensures
that everyone has the ability to adapt and reuse the documentation that we
create. But it also means that we need to be careful about what other 3rd party
material we use in our documentation. Until you are familiar with the Apache
rules for using 3rd party material into an Apache product, you should start a
discussion on the mailing list for any 3rd party material you want to reuse.
This includes material from the legacy OpenOffice.org project as well, since
some of that was under a different license.</li>
+<li>We're aiming to provide as much content as possible in the form of MWiki
pages. These are easy for users to access, from any device. Also, since they
are indexed by search engines they will be easy to find for the users who like
to resolve issues by searching Google for solutions.</li>
+</ul>
+<h2 id="volunteers-are-welcome">Volunteers are Welcome<a class="headerlink"
href="#volunteers-are-welcome" title="Permanent link">¶</a></h2>
+<p>We're looking for volunteers with technical writing experience, a good
working knowledge of OpenOffice, or ideally both. The ability to collaborate
with others in written English on the mailing list is required, but you just
need to be understandable. For the actual writing, we have editor volunteers
who will review and edit the rough drafts to fix any language errors. So you
don't need to have native-level English skills.</p>
<p>For some specialized areas skills in graphic design and programming are
also useful.</p>
<p>Volunteers on the Documentation Team work on a variety of tasks,
including:</p>
<ul>
@@ -160,20 +165,19 @@ language errors. So you don't need to h
<li>Preparing screenshots, diagrams and artwork for covers.</li>
<li>Developing tools and scripts to aid in repetitive tasks, such as document
format conversions.</li>
</ul>
-<h2 id="getting-started">Getting Started</h2>
-<p>The Documentation Team is the easiest one to get started with. There are
just a few basic steps:</p>
+<h2 id="getting-started">Getting Started<a class="headerlink"
href="#getting-started" title="Permanent link">¶</a></h2>
+<p>The Documentation Team is the easiest one to get started with. There are
just a few basic steps:</p>
<ol>
-<li>Subscribe to our Documentation mailing list by sending an email to <a
href="mailto:[email protected]";>[email protected]</a>.
</li>
-<li>Sign up for an account on our MWiki by sending an e-mail with your
preferred user name and e-mail address to the <a
href="mailto:[email protected]?subject=Requesting%20MWiki%20Account";>Documentation
mailing list</a></li>
-<li>Sign up for an account on <a
href="https://cwiki.apache.org/confluence/display/OOOUSERS/Wiki+Home";>our
CWiki</a> (Why do we have two wikis? It is a long
story...)<strong>Note:</strong> <strong>After creation the account must be
whitelisted by sending a request with the account name to the <a
href="mailto:[email protected]?subject=Whitelist%20CWiki%20Account";>Documentation
mailing list</a></strong></li>
+<li>Subscribe to our Documentation mailing list by sending an email to <a
href="mailto:[email protected]";>[email protected]</a>.
</li>
+<li>Sign up for an account on our MWiki by sending an e-mail with your
preferred user name and e-mail address to the <a
href="mailto:[email protected]?subject=Requesting MWiki
Account">Documentation mailing list</a></li>
+<li>Sign up for an account on <a
href="https://cwiki.apache.org/confluence/display/OOOUSERS/Wiki+Home";>our
CWiki</a> (Why do we have two wikis? It is a long
story...)<strong>Note:</strong> <strong>After creation the account must be
whitelisted by sending a request with the account name to the <a
href="mailto:[email protected]?subject=Whitelist CWiki
Account">Documentation mailing list</a></strong></li>
<li>Add your name to our <a
href="https://cwiki.apache.org/confluence/display/OOOUSERS/Directory+of+Volunteers";>Directory
of Volunteers</a> and
<a
href="https://cwiki.apache.org/confluence/display/OOOUSERS/Documentation+Volunteers";>Documentation
Volunteers</a> pages.</li>
-<li>Send an email to the <a
href="mailto:[email protected]?subject=New%20Doc%20Volunteer";>Documentation
mailing list</a> and introduce yourself. </li>
+<li>Send an email to the <a
href="mailto:[email protected]?subject=New Doc
Volunteer">Documentation mailing list</a> and introduce yourself.</li>
</ol>
<p>We can then bring you up to speed on what we're currently working on.</p>
-<h2 id="module-completion">Module Completion</h2>
-<p>Once you have completed this module, go to our our <a
href="https://cwiki.apache.org/confluence/display/OOOUSERS/Directory+of+Volunteers";>Directory
of Volunteers</a> wiki page and add or update
-your information. Congratulations! Please send a note to <a
href="mailto:[email protected]?subject=Completed%20Introduction%20to%20Documentation";>[email protected]</a>
so we know.</p>
+<h2 id="module-completion">Module Completion<a class="headerlink"
href="#module-completion" title="Permanent link">¶</a></h2>
+<p>Once you have completed this module, go to our our <a
href="https://cwiki.apache.org/confluence/display/OOOUSERS/Directory+of+Volunteers";>Directory
of Volunteers</a> wiki page and add or update your information.
Congratulations! Please send a note to <a
href="mailto:[email protected]?subject=Completed Introduction to
Documentation">[email protected]</a> so we know.</p>
</div>
<div id="footera">
