blob: 63de1213db911776d5bdcdca2a743a1c46704d6e [file] [log] [blame]
<!doctype html>
<!--
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
https://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.
-->
<html lang="en" prefix="og: https://ogp.me/ns#">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Introduction to Contributing to Apache OpenOffice</title>
<!-- Below Meta Tags Generated via https://www.opengraph.xyz -->
<!-- If you don't care about social media then remove this section -->
<!-- Values are set in pelicanconf.py -->
<!-- HTML Meta Tags -->
<meta name="description" content="The official developer website of the Apache OpenOffice open source project, home of OpenOffice Writer, Calc, Impress, Draw and Base.">
<meta name="keywords" content="OpenOffice, Open Office, Apache OpenOffice, Apache Open Office, OpenOffice.org, Developer, Project, Website, Official, Writer, Calc, Impress, Draw, Base, ODF, Open Document Format">
<!-- Facebook Meta Tags -->
<meta property="og:url" content="https://openoffice.apache.org">
<meta property="og:type" content="website">
<meta property="og:title" content="Apache OpenOffice">
<meta property="og:description" content="The official developer website of the Apache OpenOffice open source project, home of OpenOffice Writer, Calc, Impress, Draw and Base.">
<meta property="og:image" content="https://openoffice.apache.org/images/AOO4_website_logo.png">
<!-- Twitter Meta Tags -->
<meta name="twitter:card" content="summary_large_image">
<meta property="twitter:domain" content="openoffice.apache.org">
<meta property="twitter:url" content="https://openoffice.apache.org">
<meta name="twitter:title" content="Apache OpenOffice">
<meta name="twitter:description" content="The official developer website of the Apache OpenOffice open source project, home of OpenOffice Writer, Calc, Impress, Draw and Base.">
<meta name="twitter:image" content="https://openoffice.apache.org/images/AOO4_website_logo.png">
<!-- Above Meta Tags Generated via https://www.opengraph.xyz -->
<link rel="shortcut icon" href="/favicon.ico" type="image/x-icon" />
<link rel="icon" href="/favicon.ico" type="image/x-icon" />
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body id="index" class="home">
<div id="banner">
<div id="bannerleft"><a alt="Apache OpenOffice" href="/">
<img id="logo" alt="Apache OpenOffice" src="/images/AOO4_website_logo.png" height="60" width="161"/></a></div>
<div id="bannercenter">The Free and Open Productivity Suite</div>
</div>
<div id="clear"></div>
<nav class="navbar navbar-expand-sm navbar-dark bg-primary">
<button class="navbar-toggler" type="button"
data-toggle="collapse" data-target="#navbarSupportedContent"
aria-controls="navbarSupportedContent" aria-expanded="false"
aria-label="Toggle navigation">
<span class="navbar-toggler-icon"></span>
</button>
<div class="collapse navbar-collapse" id="navbarSupportedContent">
<ul class="navbar-nav mr-auto">
<li class="nav-item active dropdown">
<a class="nav-link dropdown-toggle" href="#" id="generalDropdown"
role="button" data-toggle="dropdown" aria-expanded="false">General</a>
<ul class="dropdown-menu" aria-labelledby="generalDropdown">
<li><a class="dropdown-item" href="/index.html">About</a></li>
<li><a class="dropdown-item" href="/downloads.html">Downloads</a></li>
<li><a class="dropdown-item" href="/license.html">License</a></li>
<li><a class="dropdown-item" href="/trademarks.html">Trademarks</a></li>
<li><a class="dropdown-item" href="/press.html">Press</a></li>
<li><a class="dropdown-item" href="https://www.openoffice.org/">OpenOffice.org</a></li>
</ul>
</li>
<li class="nav-item active dropdown">
<a class="nav-link dropdown-toggle" href="#" id="communityDropdown"
role="button" data-toggle="dropdown" aria-expanded="false">Community</a>
<ul class="dropdown-menu" aria-labelledby="communityDropdown">
<li><a class="dropdown-item" href="/get-involved.html">Get Involved</a></li>
<li><a class="dropdown-item" href="/orientation/index.html">Orientation</a></li>
<li><a class="dropdown-item" href="/mailing-lists.html">Mailing Lists</a></li>
<li><a class="dropdown-item" href="/social.html">Social Networking</a></li>
<li><a class="dropdown-item" href="/events.html">Events</a></li>
<li><a class="dropdown-item" href="https://www.openoffice.org/support/">Support</a></li>
<li><a class="dropdown-item" href="/native-lang.html">Native Language</a></li>
<li><a class="dropdown-item" href="https://cwiki.apache.org/confluence/display/OOOUSERS/">Planning Wiki</a></li>
<li><a class="dropdown-item" href="/people.html">People</a></li>
<li><a class="dropdown-item" href="/community-faqs.html">Community FAQs</a></li>
</ul>
</li>
<li class="nav-item active dropdown">
<a class="nav-link dropdown-toggle" href="#" id="developmentDropdown"
role="button" data-toggle="dropdown" aria-expanded="false">Development</a>
<ul class="dropdown-menu" aria-labelledby="developmentDropdown">
<li><a class="dropdown-item" href="/source.html">Source Code</a></li>
<li><a class="dropdown-item" href="/bug-tracking.html">Bug Tracking</a></li>
<li><a class="dropdown-item" href="/qa.html">Quality Assurance</a></li>
<li><a class="dropdown-item" href="/translate.html">Translation</a></li>
<li><a class="dropdown-item" href="/website-local.html">Website</a></li>
<li><a class="dropdown-item" href="/security.html">Security Reports</a></li>
<li><a class="dropdown-item" href="/contributing-code.html">Contributing Code</a></li>
<li><a class="dropdown-item" href="/developer-faqs.html">Developer FAQs</a></li>
</ul>
</li>
<li class="nav-item active dropdown">
<a class="nav-link dropdown-toggle" href="#" id="projectDropdown"
role="button" data-toggle="dropdown" aria-expanded="false">Project</a>
<ul class="dropdown-menu" aria-labelledby="projectDropdown">
<li><a class="dropdown-item" href="https://blogs.apache.org/OOo/">Project Blog</a></li>
<li><a class="dropdown-item" href="/pmc-faqs.html">PMC FAQs</a></li>
</ul>
</li>
</ul>
<div class="navbar-nav" style="padding-top: 0.5rem;">
<div class="nav-item dropdown dropdown-menu-right active">
<a class="nav-link dropdown-toggle" href="#"
role="button" data-toggle="dropdown" aria-haspopup="true"
aria-expanded="false"><img src="https://www.apache.org/foundation/press/kit/feather.svg"
width="32" height="32" class="d-inline-block align-top"
alt="Apache Feather">The ASF</a>
<div class="dropdown-menu dropdown-menu-right">
<a class="dropdown-item" href="https://www.apache.org/">Website</a>
<a class="dropdown-item" href="https://www.apache.org/licenses/">License</a>
<a class="dropdown-item" href="https://www.apache.org/security/">Security</a>
<a class="dropdown-item" href="https://www.apache.org/events/current-event">Events</a>
<a class="dropdown-item" href="https://www.openoffice.org/donations.html">Donations</a>
<a class="dropdown-item" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
<a class="dropdown-item" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
</div>
</div>
</div>
</div> </nav>
<div id="contenta">
<br/>
<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 lists.</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:recruitment@openoffice.apache.org?subject=Starting%20Introduction%20to%20Contributing%20to%20Apache%20OpenOffice%20Module">recruitment@openoffice.apache.org</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>
<ol>
<li><a href="https://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="https://www.apache.org/foundation/faq.html">ASF FAQ's</a> (browse to see if it answers any questions you might have)</li>
<li><a href="https://en.wikipedia.org/wiki/OpenOffice">OpenOffice Wikipedia article</a> (for basic historical background)</li>
<li><a href="https://smartbear.com/blog/test-and-monitor/14-ways-to-contribute-to-open-source-without-being/">14 Ways to Contribute to Open Source without Being a Programming Genius or a Rock Star</a></li>
</ol>
</li>
<li>
<p>As a globally-distributed all-recruitment 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 Recruitment should be on:</p>
<ol>
<li><a href="/mailing-lists.html#development-mailing-list-public">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="/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="/mailing-lists.html#users-mailing-list-public">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="/mailing-lists.html">project functions</a> and <a href="/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 <a href="mailto:dev@openoffice.apache.org">dev@openoffice.apache.org</a> can be tedious. So you will often see it called just "dev@". Similarly, top-level lists like <a href="mailto:trademarks@apache.org">trademarks@apache.org</a> 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 Recruitment 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="/mailing-lists.html#participation-guidelines">Participation Guidelines</a> and <a href="/list-conduct.html">List Conduct Guidelines</a> for more information.</p>
</li>
<li>
<p>From Karl Fogel's book <a href="https://producingoss.com/">"Producing Open Source Software"</a> read through <a href="https://producingoss.com/en/communications.html#you-are-what-you-write">"You Are What You Write"</a> and <a href="https://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 recruitment should be signed up for:</p>
<ol>
<li>Our <a href="https://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="https://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="/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+Volunteerss">Directory of Volunteers</a> wiki page and add your information. Congratulations! Please send a note to <a href="mailto:recruitment@openoffice.apache.org?subject=Completed%20Introduction%20to%20Contributing%20to%20Apache%20OpenOffice%20Module">recruitment@openoffice.apache.org</a> so we know.</p>
</li>
</ol>
</div>
<footer class="navbar-expand-lg navbar-light bg-light">
<div class="footer" id="footer">
<div class="container-fluid">
Copyright &copy; 2011-2021 The Apache Software Foundation,
Licensed under the
<a href="https://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0.</a> | <a href="/contact.html">Contact Us</a> | <a href="/terms.html">Terms of Use</a> | <a href="/privacy.html">Privacy</a>
<br/>
Apache, OpenOffice, OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation.
The Apache feather logo is a trademark of The Apache Software Foundation.
Other names appearing on the site may be trademarks of their respective owners.
</div><!-- #container-fluid -->
<div class="row container-fluid">
<div class="col-sm">
<a href="https://www.apache.org/">
<img src="https://www.apache.org/img/asf_logo.png" alt="The Apache Software Foundation" style="border: 0; margin-top: 2px" width="200" height="82">
</a>
</div>
<div class="col-sm center-align">
<a href="https://www.apache.org/foundation/contributing.html">
<img src="https://www.apache.org/images/SupportApache-small.png" alt="Support The ASF" height="80" width="80">
</a>
</div>
<div class="col-sm right-align">
<a class="acevent" data-format="wide" data-mode="light" data-event="random"></a>
</div>
</div>
</div>
</footer>
<!-- Start load of stylesheets (will need to upgrade periodically) -->
<link rel="stylesheet"
href="https://stackpath.bootstrapcdn.com/bootstrap/4.3.1/css/bootstrap.min.css"
integrity="sha384-ggOyR0iXCbMQv3Xipma34MD+dH/1fQ784/j6cY/iJTQUOhcWr7x9JvoRxT2MZw1T"
crossorigin="anonymous">
<link rel="stylesheet"
href="https://cdnjs.cloudflare.com/ajax/libs/github-markdown-css/3.0.1/github-markdown.min.css"
crossorigin="anonymous">
<link href="/theme/css/openoffice.css" rel="stylesheet" type="text/css">
<!-- End stylesheets -->
<!-- Start the loading of javascript frameworks (will need to upgrade periodically) -->
<script src="https://www.apachecon.com/event-images/snippet.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.6.0/jquery.slim.min.js"
integrity="sha512-6ORWJX/LrnSjBzwefdNUyLCMTIsGoNP6NftMy2UAm1JBm6PRZCO1d7OHBStWpVFZLO+RerTvqX/Z9mBFfCJZ4A=="
crossorigin="anonymous"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.7/umd/popper.min.js"
integrity="sha384-UO2eT0CpHqdSJQ6hJty5KVphtPhzWj9WO1clHTMGa3JDZwrnQq4sF86dIHNDz0W1"
crossorigin="anonymous"></script>
<script src="https://stackpath.bootstrapcdn.com/bootstrap/4.3.1/js/bootstrap.min.js"
integrity="sha384-JjSmVgyd0p3pXB1rRibZUAYoIIy6OrQ6VrjIEaFf/nJGzIxFDsf4x0xIM+B07jRM"
crossorigin="anonymous"></script>
<!-- End the loading of javascript frameworks -->
<!-- Source: orientation/intro-contributing.md; Template: page; Url: orientation/intro-contributing.html -->
</body>
</html>