Difference between revisions of "Documentation/Dashboard/Introducing OOoAuthors"

From Apache OpenOffice Wiki
Jump to: navigation, search
 
(14 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:Introducing OOoAuthors}}
+
{{DISPLAYTITLE:Introducing ODFAuthors}}
  
 +
{{Hurrah}}
  
 
This document should be read in conjunction with [[Documentation/Dashboard/Producing_User_Guides|Producing {{OOo}} User Guides]].
 
This document should be read in conjunction with [[Documentation/Dashboard/Producing_User_Guides|Producing {{OOo}} User Guides]].
  
 +
== What is ODFAuthors? ==
 +
ODFAuthors is a group of volunteers who produce ''user guides'' for the OpenOffice.org (OOo) office suite in several languages. These guides are then made available in various forms (ODT, PDF, MediaWiki) through the OOo Documentation Project and the relevant language groups at OOo. The guides can also be used, with minor modifications, by other projects including LibreOffice, Go-OO, NeoOffice, and others.
  
== What is OOoAuthors? ==
+
Other forms of OOo user documentation (FAQs, HowTos, tutorials, training materials) may be produced by the ODFAuthors group or by other people. Documentation for developers and system administrators is produced by other people within the OpenOffice.org community.
OOoAuthors is a group of volunteer who produce ''user guides'' for the OpenOffice.org (OOo) office suite in several languages. These guides are then made available in various forms (ODT, PDF, MediaWiki) through the OOo Documentation Project and the relevant language groups at OOo. The guides can also be used, with minor modifications, by other projects including LibreOffice, Go-OO, NeoOffice, and others.
+
  
Other forms of OOo user documentation (FAQs, HowTos, tutorials, training materials) may be produced by the OOoAuthors group or by other people. Documentation for developers and system administrators is produced by other people within the OpenOffice.org community.
+
{{Note|OpenOffice.org is in transition from Oracle Corp. to Apache. Many details about the project are likely to change within the next few months.}}
  
This diagram shows the relationship between OOoAuthors and the OpenOffice.org Documentation Project.
+
The ODFAuthors website, [http://www.odfauthors.org/ http://www.odfauthors.org/] is where most of the work on the user guides takes place. See [[#Using the ODFAuthors website|Using the ODFAuthors website]].
 
+
[[Image:oooa-fig1.png|thumb|none|600px|''Production and distribution of documentation'']]
+
 
+
The OOoAuthors website, [http://www.oooauthors.org/ http://www.oooauthors.org/] is where most of the work on the user guides takes place. See [[#Using the OOoAuthors website|Using the OOoAuthors website]].
+
  
 
The OOo wiki, [http://wiki.services.openoffice.org/wiki/Documentation/ http://wiki.services.openoffice.org/wiki/Documentation/] is the current home for most OOo documentation. Some materials are maintained on the wiki; others are maintained elsewhere and made available through the wiki. The wiki is also used for collaborative planning and tracking of work including the user guides. See [[#Using the OOo wiki|Using the OOo wiki]].
 
The OOo wiki, [http://wiki.services.openoffice.org/wiki/Documentation/ http://wiki.services.openoffice.org/wiki/Documentation/] is the current home for most OOo documentation. Some materials are maintained on the wiki; others are maintained elsewhere and made available through the wiki. The wiki is also used for collaborative planning and tracking of work including the user guides. See [[#Using the OOo wiki|Using the OOo wiki]].
Line 20: Line 18:
 
The OpenOffice.org website, [http://documentation.openoffice.org/ http://documentation.openoffice.org/] is mainly a pointer to the location of available documentation and a respository for some historical material. The entire OOo website is being moved to a new platform, providing the opportunity to reorganize current material and archive out of date material. Most contributors do not interact with this website very often; only a few people have write-access to any of its pages.
 
The OpenOffice.org website, [http://documentation.openoffice.org/ http://documentation.openoffice.org/] is mainly a pointer to the location of available documentation and a respository for some historical material. The entire OOo website is being moved to a new platform, providing the opportunity to reorganize current material and archive out of date material. Most contributors do not interact with this website very often; only a few people have write-access to any of its pages.
  
== Joining OOoAuthors ==
+
== Joining ODFAuthors ==
To read published documents on the wiki, the OOo website, or the OOoAuthors website, you do not need to get a login or join a mailing list. However, to participate fully in OOoAuthors, you need to have a login for both the OOoAuthors website and the OOo wiki and you need to join our mailing list.
+
To '''read''' published documents on the wiki, the OOo website, or the ODFAuthors website, you do not need to get a login or join a mailing list. However, to participate fully in ODFAuthors, you need to have a login for both the ODFAuthors website and the OOo wiki and you need to join our mailing list.
  
 
We also recommend having a login for the main OOo website (so you can file issues—bugs—if you find them while using the product) and joining the OOo Documentation project and its mailing list.
 
We also recommend having a login for the main OOo website (so you can file issues—bugs—if you find them while using the product) and joining the OOo Documentation project and its mailing list.
  
 
=== Logins ===
 
=== Logins ===
You can use the same login name for all the websites, but you must register separately at each of them. In each case, you will find a '''Register''' link in the upper right of the web page. Fill in the form that appears. Your registration is effective immediately.
+
You can use the same login name for all the websites, but you must register separately at each of them.  
  
'''OOoAuthors website'''
+
'''ODFAuthors website'''
  
Go to [http://www.oooauthors.org/ http://www.oooauthors.org/].
+
Please write to [mailto:webmaster@odfauthors.org webmaster@odfauthors.org] and request an account. (We had to stop self-registration because of too many spam accounts.)
  
 
'''OOo wiki'''
 
'''OOo wiki'''
  
Go to [http://wiki.services.openoffice.org/wiki/Documentation/ http://wiki.services.openoffice.org/wiki/Documentation/].
+
Go to [http://wiki.services.openoffice.org/wiki/Documentation/ http://wiki.services.openoffice.org/wiki/Documentation/]. You will find a '''Register''' link in the upper right of the web page. Fill in the form that appears. Your registration is effective immediately.
  
 
'''OpenOffice.org website'''
 
'''OpenOffice.org website'''
  
Go to [http://documentation.openoffice.org/ http://documentation.openoffice.org/] or any page on the openoffice.org website.
+
Go to [http://documentation.openoffice.org/ http://documentation.openoffice.org/] or any page on the openoffice.org website. You will find a '''Register''' link in the upper right of the web page. Fill in the form that appears. Your registration is effective immediately.
 
+
'''Joining the Documentation Project'''
+
 
+
Go to [http://documentation.openoffice.org/ http://documentation.openoffice.org/]. In the boxed section titled ''Welcome to the Documentation Project!'', click on the link '''signing up'''. On the ''Request project role'' page, one choice is available: ''Observer''. Click '''Submit request'''. Requests must be approved. In most cases this happens within a day or two, but lack of approval does not stop you from participating.
+
  
 
=== Mailing lists ===
 
=== Mailing lists ===
We have two main mailing lists:
+
During the transition of OpenOffice.org from Oracle to Apache, we have two main mailing lists:
  
* [mailto:dev@documentation.openoffice.org dev@documentation.openoffice.org], for discussions related to project infrastructure and policy.
+
* [mailto:ooo-dev@incubator.apache.org ooo-dev@incubator.apache.org] (Apache-OOo) for discussions related to OpenOffice.org (not just Documentation) project infrastructure and policy.
* [mailto:authors@documentation.openoffice.org authors@documentation.openoffice.org], where writers, editors, reviewers, and others discuss documents they are working on.
+
* [mailto:odfauthors-discuss@lists.odfauthors.org odfauthors-discuss@lists.odfauthors.org] (ODFAuthors), where writers, editors, reviewers, and others discuss documents they are working on.
  
We recommend you subscribe to each of these mailing lists. If you do not subscribe, any message you send will be delayed while a moderator finds time to approve them, and you will not see any replies to your messages. Thus you will not be able to participate effectively with the team.
+
We recommend you subscribe to each of these mailing lists. The ODFAuthors list is essential: if you do not subscribe, any message you send will be delayed while a moderator finds time to approve it, and you will not see any replies to your messages. Thus you will not be able to participate effectively with the team.
  
{{Documentation/Note|The lists are public and messages posted to them can be found through Google and other archives. Some people choose to use pseudonyms on the mailing lists for this reason.}}
+
{{Note|The lists are public and messages posted to them can be found through Google and other archives. Some people choose to use pseudonyms or list-specific email addresses on the mailing lists for this reason.}}
  
 
'''Join a list'''
 
'''Join a list'''
  
To join the Documentation list, send a blank email to [mailto:dev-subscribe@documentation.openoffice.org dev-subscribe@documentation.openoffice.org]
+
To join the Apache-OOo list, send a blank email to [mailto:ooo-dev-subscribe@incubator.apache.org ooo-dev-subscribe@incubator.apache.org].
  
To join the Authors list, send a blank email to [mailto:authors-subscribe@documentation.openoffice.org authors-subscribe@documentation.openoffice.org]
+
To join the ODFAuthors list, send a blank email to [mailto:odfauthors-discuss-subscribe@lists.odfauthors.org odfauthors-discuss-subscribe@lists.odfauthors.org].
  
 
In each case, you will receive a confirmation email. You must respond to this email to confirm your subscription.
 
In each case, you will receive a confirmation email. You must respond to this email to confirm your subscription.
Line 64: Line 58:
 
'''Post to a list'''
 
'''Post to a list'''
  
To post to one of the lists, send an email to [mailto:authors@documentation.openoffice.org authors@documentation.openoffice.org] (Authors) or[mailto:dev@documentation.openoffice.org dev@documentation.openoffice.org] (Docs)
+
To post to one of the lists, send an email to one of the addresses given.
  
 
Please send an email to the list to introduce yourself.
 
Please send an email to the list to introduce yourself.
Line 70: Line 64:
 
'''Read list archives'''
 
'''Read list archives'''
  
To read the archives of the Authors list, go to [http://documentation.openoffice.org/servlets/SummarizeList?listName=authors http://documentation.openoffice.org/servlets/SummarizeList?listName=authors]
+
To read the archives of the ODFAuthors list, go to [https://lists.odfauthors.org/pipermail/odfauthors-discuss/ https://lists.odfauthors.org/pipermail/odfauthors-discuss/]
 
+
To read the archives of the Apache-OOo list, go to [http://mail-archives.apache.org/mod_mbox/incubator-ooo-dev/ http://mail-archives.apache.org/mod_mbox/incubator-ooo-dev/]
To read the archives of the Docs list, go to [http://documentation.openoffice.org/servlets/SummarizeList?listName=dev http://documentation.openoffice.org/servlets/SummarizeList?listName=dev]
+
  
 
'''Unsubscribe from a list'''
 
'''Unsubscribe from a list'''
  
If you need to unsubscribe from either list, send an email from the subscribed address to [mailto:authors-unsubscribe@documentation.openoffice.org authors-unsubscribe@documentation.openoffice.org] or [mailto:dev-unsubscribe@documentation.openoffice.org dev-unsubscribe@documentation.openoffice.org]  
+
If you need to unsubscribe from either list, send a blank email from the subscribed address to [mailto:odfauthors-discuss-unsubscribe@lists.odfauthors.org odfauthors-discuss-unsubscribe@lists.odfauthors.org] (TDFAuthors) or [mailto:ooo-dev-unsubscribe@incubator.apache.org ooo-dev-unsubscribe@incubator.apache.org] (Apache-OOo).
  
 
In each case, you will receive a confirmation email. You must respond to this email to confirm your unsubscription.
 
In each case, you will receive a confirmation email. You must respond to this email to confirm your unsubscription.
  
== First steps with OOoAuthors ==
+
== First steps with ODFAuthors ==
 
Once that you have a website login and have joined the mailing list and introduced yourself, we recommend the following steps:
 
Once that you have a website login and have joined the mailing list and introduced yourself, we recommend the following steps:
  
Line 97: Line 90:
 
# Check the Review List on the OOoAuthors website. This list is visible when you are logged in and have the Author role.
 
# Check the Review List on the OOoAuthors website. This list is visible when you are logged in and have the Author role.
  
== Using the OOoAuthors website ==
+
== Using the ODFAuthors website ==
The OOoAuthors website uses a content management system called Plone. It is quite easy to use once you become familiar with it.
+
The ODFAuthors website uses a content management system called Plone. It is quite easy to use once you become familiar with it.
  
{{Documentation/Note|You must be logged in and have the Author role to be able to use the features discussed in this section.}}
+
{{Note|You must be logged in and have the Author role to be able to use the features discussed in this section.}}
  
Our workflow in the English section of OOoAuthors is shown below.
+
Our workflow in the English section of ODFAuthors is shown below.
  
 
[[Image:oooa-fig2.png|thumb|none|600px|''Workflow'']]
 
[[Image:oooa-fig2.png|thumb|none|600px|''Workflow'']]
  
The English section of the OOoAuthors has this hierarchy:
+
The English section of the ODFAuthors has this hierarchy:
  
 
[[Image:oooa-fig3.png|thumb|none|600px|''Hierarchy of folders'']]
 
[[Image:oooa-fig3.png|thumb|none|600px|''Hierarchy of folders'']]
Line 115: Line 108:
 
To retract a document:
 
To retract a document:
  
# On the OOoAuthors website, go to the folder containing the document.
+
# On the ODFAuthors website, go to the folder containing the document.
 
# Click on the filename to go to the View page for the file.
 
# Click on the filename to go to the View page for the file.
 
# Click on the down-arrow by ''state: pending review'' and select '''retract''' from the drop-down list. The state will change to ''internal draft''.
 
# Click on the down-arrow by ''state: pending review'' and select '''retract''' from the drop-down list. The state will change to ''internal draft''.
Line 123: Line 116:
  
 
=== How to upload a document ===
 
=== How to upload a document ===
# On the OOoAuthors website, go to the correct folder for the book you’re working on: Drafts if you’re writing a chapter; Feedback if you’re reviewing or editing it.
+
# On the ODFAuthors website, go to the correct folder for the book you’re working on: Drafts if you’re writing a chapter; Feedback if you’re reviewing or editing it.
 
# On the View page of the folder, click '''add new > file'''.
 
# On the View page of the folder, click '''add new > file'''.
 
# On the Add File page, type a name for the document (for example, ''How to Upload a Document'') in the Title box and type an optional description.
 
# On the Add File page, type a name for the document (for example, ''How to Upload a Document'') in the Title box and type an optional description.

Latest revision as of 13:34, 7 July 2018


HURRAH!!    We've moved! We're here!

Please expect temporary outages.

See Moving Day for the latest news.
_______________________________________


This document should be read in conjunction with Producing Apache OpenOffice User Guides.

What is ODFAuthors?

ODFAuthors is a group of volunteers who produce user guides for the OpenOffice.org (OOo) office suite in several languages. These guides are then made available in various forms (ODT, PDF, MediaWiki) through the OOo Documentation Project and the relevant language groups at OOo. The guides can also be used, with minor modifications, by other projects including LibreOffice, Go-OO, NeoOffice, and others.

Other forms of OOo user documentation (FAQs, HowTos, tutorials, training materials) may be produced by the ODFAuthors group or by other people. Documentation for developers and system administrators is produced by other people within the OpenOffice.org community.

Documentation note.png OpenOffice.org is in transition from Oracle Corp. to Apache. Many details about the project are likely to change within the next few months.

The ODFAuthors website, http://www.odfauthors.org/ is where most of the work on the user guides takes place. See Using the ODFAuthors website.

The OOo wiki, http://wiki.services.openoffice.org/wiki/Documentation/ is the current home for most OOo documentation. Some materials are maintained on the wiki; others are maintained elsewhere and made available through the wiki. The wiki is also used for collaborative planning and tracking of work including the user guides. See Using the OOo wiki.

The OpenOffice.org website, http://documentation.openoffice.org/ is mainly a pointer to the location of available documentation and a respository for some historical material. The entire OOo website is being moved to a new platform, providing the opportunity to reorganize current material and archive out of date material. Most contributors do not interact with this website very often; only a few people have write-access to any of its pages.

Joining ODFAuthors

To read published documents on the wiki, the OOo website, or the ODFAuthors website, you do not need to get a login or join a mailing list. However, to participate fully in ODFAuthors, you need to have a login for both the ODFAuthors website and the OOo wiki and you need to join our mailing list.

We also recommend having a login for the main OOo website (so you can file issues—bugs—if you find them while using the product) and joining the OOo Documentation project and its mailing list.

Logins

You can use the same login name for all the websites, but you must register separately at each of them.

ODFAuthors website

Please write to webmaster@odfauthors.org and request an account. (We had to stop self-registration because of too many spam accounts.)

OOo wiki

Go to http://wiki.services.openoffice.org/wiki/Documentation/. You will find a Register link in the upper right of the web page. Fill in the form that appears. Your registration is effective immediately.

OpenOffice.org website

Go to http://documentation.openoffice.org/ or any page on the openoffice.org website. You will find a Register link in the upper right of the web page. Fill in the form that appears. Your registration is effective immediately.

Mailing lists

During the transition of OpenOffice.org from Oracle to Apache, we have two main mailing lists:

We recommend you subscribe to each of these mailing lists. The ODFAuthors list is essential: if you do not subscribe, any message you send will be delayed while a moderator finds time to approve it, and you will not see any replies to your messages. Thus you will not be able to participate effectively with the team.

Documentation note.png The lists are public and messages posted to them can be found through Google and other archives. Some people choose to use pseudonyms or list-specific email addresses on the mailing lists for this reason.

Join a list

To join the Apache-OOo list, send a blank email to ooo-dev-subscribe@incubator.apache.org.

To join the ODFAuthors list, send a blank email to odfauthors-discuss-subscribe@lists.odfauthors.org.

In each case, you will receive a confirmation email. You must respond to this email to confirm your subscription.

Post to a list

To post to one of the lists, send an email to one of the addresses given.

Please send an email to the list to introduce yourself.

Read list archives

To read the archives of the ODFAuthors list, go to https://lists.odfauthors.org/pipermail/odfauthors-discuss/ To read the archives of the Apache-OOo list, go to http://mail-archives.apache.org/mod_mbox/incubator-ooo-dev/

Unsubscribe from a list

If you need to unsubscribe from either list, send a blank email from the subscribed address to odfauthors-discuss-unsubscribe@lists.odfauthors.org (TDFAuthors) or ooo-dev-unsubscribe@incubator.apache.org (Apache-OOo).

In each case, you will receive a confirmation email. You must respond to this email to confirm your unsubscription.

First steps with ODFAuthors

Once that you have a website login and have joined the mailing list and introduced yourself, we recommend the following steps:

  1. Read about the licenses we apply to any work contributed to the user guides and be sure you are comfortable with these licenses:
  2. Write to the Authors list and ask for the Author role. Mention the real name you gave when registering so we can find you in the list of members. Without the Author role, your access is limited to published documents and you will not see the list of documents awaiting review nor any of the draft documents themselves. With the Author role, you can view and download files at the internal draft or published internally stages and also add files to the OOoAuthors website.
  3. Read these reference documents:
  4. Get the latest stable version of OOo from the first page of the OOo website, http://www.openoffice.org/
  5. Get the latest Developer Snapshot of the next version of OOo from http://download.openoffice.org/next/index.html
  6. Check the user guide task list to find things that interest you or have a high priority need for help, http://wiki.services.openoffice.org/wiki/Documentation/Dashboard/User_Guides
  7. Check the Review List on the OOoAuthors website. This list is visible when you are logged in and have the Author role.

Using the ODFAuthors website

The ODFAuthors website uses a content management system called Plone. It is quite easy to use once you become familiar with it.

Documentation note.png You must be logged in and have the Author role to be able to use the features discussed in this section.

Our workflow in the English section of ODFAuthors is shown below.

Workflow

The English section of the ODFAuthors has this hierarchy:

Hierarchy of folders

How to retract a document

Retracting a document removes a submitted file from the Review List. If you are reviewing a chapter, please retract the chapter so others know it is being worked on and don’t duplicate your work. Sometimes the author will request multiple simultaneous reviews; in that case, do not retract the document.

To retract a document:

  1. On the ODFAuthors website, go to the folder containing the document.
  2. Click on the filename to go to the View page for the file.
  3. Click on the down-arrow by state: pending review and select retract from the drop-down list. The state will change to internal draft.
  4. To download the file from that same page, click on its name. A download box opens. If your browser gives you a choice of Open with OpenOffice.org or Save File, choose Save File.
Retracting a document

How to upload a document

  1. On the ODFAuthors website, go to the correct folder for the book you’re working on: Drafts if you’re writing a chapter; Feedback if you’re reviewing or editing it.
  2. On the View page of the folder, click add new > file.
  3. On the Add File page, type a name for the document (for example, How to Upload a Document) in the Title box and type an optional description.
  4. Click the Browse button, find the file on your computer, select it, and click Save. The upload process should complete within a few minutes. There is no progress indicator.
  5. If the file is in the Feedback folder, you are done.
Uploading a document

If the file is in the Drafts folder and needs to be reviewed or edited, go to “How to submit a document” below.

How to submit a document

Submitting a document means that it is ready for others to review or edit. When a document is submitted, it shows up in the Review List.

To submit a document:

  1. If you have just uploaded the document, you should be on the View page for the file. Otherwise, go to the folder containing the document and click on the filename to go to the View page for the file.
  2. Click on the down-arrow by state: internal draft in the upper right-hand corner of the page. Select submit for publication from the drop-down list.
Submitting a document for review

Using the OOo wiki

The OOoAuthors group uses the OOo Documentation wiki, http://wiki.services.openoffice.org/wiki/Documentation/ for collaborative planning and tracking of work on the user guides. Published user guides produced by OOoAuthors are made available through the wiki.

Editing wiki pages

[To be written]

Using the Discussion tab

[To be written]

Wiki templates

[To be written]


Content on this page is licensed under the Creative Common Attribution 3.0 license (CC-BY).
Personal tools