blob: 679c19acfc3a8233457abca07dfc04463e2a0117 [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
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.
<html lang="en" prefix="og:">
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Introduction to Documentation</title> <!-- Below Meta Tags Generated via -->
<!-- If you don't care about social media then remove this section -->
<!-- Values are set in -->
<!-- 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="">
<!-- Facebook Meta Tags -->
<meta property="og:url" content="">
<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="">
<!-- Twitter Meta Tags -->
<meta name="twitter:card" content="summary_large_image">
<meta property="twitter:domain" content="">
<meta property="twitter:url" content="">
<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="">
<!-- Above Meta Tags Generated via -->
<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">
<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 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>
<!-- General menu -->
<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="/mission.html">Mission</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=""></a></li>
<!-- Community menu -->
<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="">Support</a></li>
<li><a class="dropdown-item" href="/native-lang.html">Native Language</a></li>
<li><a class="dropdown-item" href="">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>
<!-- Development menu -->
<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>
<!-- Project menu -->
<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="/blogpage.html">Project Blog</a></li>
<li><a class="dropdown-item" href="/pmc-faqs.html">PMC FAQs</a></li>
<!-- The ASF menu -->
<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=""
width="32" height="32" class="d-inline-block align-top"
alt="Apache Feather">
<div class="dropdown-menu dropdown-menu-right">
<a class="dropdown-item" href="">Website</a>
<a class="dropdown-item" href="">License</a>
<a class="dropdown-item" href="">Security</a>
<a class="dropdown-item" href="">Events</a>
<a class="dropdown-item" href="">Donations</a>
<a class="dropdown-item" href="">Sponsorship</a>
<a class="dropdown-item" href="">Thanks</a>
</div> </nav>
<div id="contenta">
<h2 id="introduction">Introduction<a class="headerlink" href="#introduction" title="Permalink">&para;</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=""></a>.</p>
<p>Then you can introduce yourself by <a href="">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="/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<a class="headerlink" href="#the-big-picture" title="Permalink">&para;</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 decades. 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>
<li>They might ask a friend for help</li>
<li>They might search Google for help</li>
<li>They might press F1 in the application and look for help</li>
<li>They might post a question to our <a href="">community support forum</a></li>
<li>They might go to the <a href=""> website</a> and look for a solution there</li>
<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="Permalink">&para;</a></h2>
<p>We maintain documentation in a variety of forms:</p>
<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>
<p>All OpenOffice documentation is housed on the <a href="">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<a class="headerlink" href="#goals-and-constraints" title="Permalink">&para;</a></h2>
<p>In our documentation work we need to be aware of the following goals and constraints:</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="">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 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>
<h2 id="volunteers-are-welcome">Volunteers are Welcome<a class="headerlink" href="#volunteers-are-welcome" title="Permalink">&para;</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>
<li>Authoring draft documentation on a specific area of the OpenOffice product.</li>
<li>Reviewing draft documentation for technical correctness, e.g., repeating the steps described in a task and verifying that they are complete and no steps are missing.</li>
<li>Editing draft documentation for clarity and style.</li>
<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>
<h2 id="getting-started">Getting Started<a class="headerlink" href="#getting-started" title="Permalink">&para;</a></h2>
<p>The Documentation Team is the easiest one to get started with. There are just a few basic steps:</p>
<li>Subscribe to our Documentation mailing list by sending an email to <a href=""></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="">Documentation mailing list</a></li>
<li>Sign up for an account on <a href="">our CWiki</a> (Why do we have two wikis? It is a long story...)<strong>Note:</strong> <strong>After creation the account must be allowed by sending a request with the account name to the <a href="">Documentation mailing list</a></strong></li>
<li>Add your name to our <a href="">Directory of Volunteers</a> and
<a href="">Documentation Volunteers</a> pages.</li>
<li>Send an email to the <a href="">Documentation mailing list</a> and introduce yourself.</li>
<p>We can then bring you up to speed on what we're currently working on.</p>
<h2 id="module-completion">Module Completion<a class="headerlink" href="#module-completion" title="Permalink">&para;</a></h2>
<p>Once you have completed this Module, go to our our <a href="">Directory of Volunteers</a> wiki page and add or update your information. Congratulations! Please send a note to <a href=""></a> so we know.</p>
<footer class="navbar-expand-lg navbar-light bg-light">
<div class="footer" id="footer">
<div class="container-fluid">
Copyright &copy; 2011-2024 The Apache Software Foundation,
Licensed under the
<a href="">Apache License, Version 2.0.</a> | <a href="/contact.html">Contact Us</a> | <a href="/terms.html">Terms of Use</a> | <a href="">Privacy</a>
Apache, OpenOffice, 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="">
<img src="" alt="The Apache Software Foundation" style="border: 0; margin-top: 2px" width="200" height="82">
<div class="col-sm center-align">
<a href="">
<img src="" alt="Support The ASF" height="80" width="80">
<div class="col-sm right-align">
<a class="acevent" data-format="wide" data-mode="light" data-event="random"></a>
<!-- Start load of stylesheets (will need to upgrade periodically) -->
<link href="/theme/css/bootstrap.min.css" rel="stylesheet" type="text/css">
<link href="/theme/css/github-markdown.min.css" rel="stylesheet" type="text/css">
<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=""></script>
<script src="/theme/js/jquery.slim.min.js"></script>
<script src="/theme/js/popper.min.js"></script>
<script src="/theme/js/bootstrap.min.js"></script>
<!-- End the loading of javascript frameworks -->
<!-- Source: pages/orientation/; Template: page; Url: pages/orientation/intro-doc.html --></body>