On 01/07/2014 01:25 PM, Keith N. McKenna wrote:
-----BEGIN PGP SIGNED MESSAGE-----
Steven;
I will be happy to go over your work later today. Just one caution on
the older User Guides. These were done by ODF Authors in th days when
Sun and Oracle sponsored the project and are under a different license
that is incompatible with the ALv2 license we are now using at Apache.
I see no problem using them as a guide for structure etc. but care
must be taken not to re-use an content.
The getting started guide has a section on Macros. The Calc guide has a
section on Calc as a simple database.
Both of these documents started as documents I created outside of ODF
Authors. The ODF Authors version may not be direct content usable, but
my original documents are. Just something to keep in mind. They would
need to be reformatted to what ever standards are used in the AOO
documents, however.
As far as the headers are concerned Header 1 by convention is used for
the tittle of the page. 1st level headers in the document should start
at level 2 and work down. Good references to use are the following
documents on the wiki:
http://wiki.openoffice.org/wiki/Documentation/Dashboard/Help_Style_Guide#Styles
http://wiki.openoffice.org/wiki/Documentation/Dashboard/Help_Style_Guide#Styles
http://wiki.openoffice.org/wiki/Documentation/Dashboard/Wiki_Editing_Policy
I usually have at least the editing policy open in a separate browser
tab for quick reference as there is a section in there of helpful
templates that are used in all of our documentation.
We use the status page as our mans of tracking were pages are. It can
be found here:
http://wiki.openoffice.org/wiki/Documentation/UserGuide/Status add you
name as author to any page that you write and use the Notes and Status
section to communicate needed info. Also keep coming to the list with
questions or concerns. This is our main tool for discussion of
anything dealing with documentation.
Regards
Keith
--
Andrew Pitonyak
My Macro Document: http://www.pitonyak.org/AndrewMacro.odt
Info: http://www.pitonyak.org/oo.php
---------------------------------------------------------------------
To unsubscribe, e-mail: doc-unsubscr...@openoffice.apache.org
For additional commands, e-mail: doc-h...@openoffice.apache.org
