How OO documentation is organized

[John Kaufmann]

As one who is still trying to make the changeover to OpenOffice, I have
searched for and found lots of documentation (even if not always with
the answers I seek).  But it has dawned on me that one of the newbie
problems is pinning down where to look first, and most regularly, for
documentation.  There are very good libraries of third-party articles in
places like:
      LinuxBeacon <http://linuxbeacon.com>
      LinuxJournal <http://www.linuxjournal.com>
      Sheepdog Guides <http://sheepdogguides.com>
      (any others of significance?)

But for systematic documentation under the auspices of openoffice.org,
there seem to be two repositories which, frankly, I can't tell apart:
      wiki.services.openoffice.org/wiki/Documentation/
      documentation.openoffice.org/
*both* of which are fed from documentation developed at
      oooauthors.org
and elsewhere.  For example, the tutorials pages
      <http://wiki.services.openoffice.org/wiki/Documentation/Tutorials>
and  <http://documentation.openoffice.org/tutorials/>
both seem to carry the same content (just somewhat differently
formatted).  Why is that?

I assume there is some reason for this divided organization, but I still
don't see what that is - and have finally decided that my learning curve
could be improved by asking for help on that point.  Can someone help me
sort out the documentation model?

John

---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@...
For additional commands, e-mail: users-help@...

[Uwe Fischer]

Hi John,

On 11/04/09 06:17, John Kaufmann wrote:

>...
> But for systematic documentation under the auspices of openoffice.org,
> there seem to be two repositories which, frankly, I can't tell apart:
>      wiki.services.openoffice.org/wiki/Documentation/
>      documentation.openoffice.org/
> *both* of which are fed from documentation developed at
>      oooauthors.org
> and elsewhere.  For example, the tutorials pages
>      <http://wiki.services.openoffice.org/wiki/Documentation/Tutorials>
> and  <http://documentation.openoffice.org/tutorials/>
> both seem to carry the same content (just somewhat differently
> formatted).  Why is that?
>
> I assume there is some reason for this divided organization, but I still
> don't see what that is - and have finally decided that my learning curve
> could be improved by asking for help on that point.  Can someone help me
> sort out the documentation model?
>
> John

welcome to the web pages of the OOo documentation project.

You already found the two entry portals. The page
documentation.openoffice.org is the normal project page, like all other
entry pages (projectname).openoffice.org.
The Wiki page exists because the documentation project wants to simplify
collaboration. Every registered user can edit and add pages on the Wiki.
That's really easy on a Wiki, while it needs some more efforts on a
"normal" web page.
The contents should be the same if possible, just the layout looks a bit
different.

Uwe
--
   ufi@...  -  Technical Writer
   StarOffice - Sun Microsystems, Inc. - Hamburg, Germany
   http://documentation.openoffice.org/
   http://wiki.services.openoffice.org/wiki/Documentation
   http://blogs.sun.com/oootnt
   http://user.services.openoffice.org/en/forum

---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@...
For additional commands, e-mail: users-help@...

[John Kaufmann]

Hi Uwe,

In a message dated 2009.11.04 04:04 -0500, Uwe Fischer wrote:

>> ... But for systematic documentation under the auspices of
>> openoffice.org, there seem to be two repositories which, frankly,
>> I can't tell apart:
>>      wiki.services.openoffice.org/wiki/Documentation/
>>      documentation.openoffice.org/
>> *both* of which are fed from documentation developed at
>>      oooauthors.org  ...
>>
>> I assume there is some reason for this divided organization, but I
>> still don't see what that is ...
>
> welcome to the web pages of the OOo documentation project.
>
> You already found the two entry portals. The page
> documentation.openoffice.org is the normal project page, like all other
> entry pages (projectname).openoffice.org.

Thank you!  That led me to the projects list
<http://www.openoffice.org/servlets/ProjectList?type=Projects&mode=TopLevel>,
which is a revelation.  I had no idea of the administrative organization
of the OpenOffice project, and exposure to that provides unexpected
insight into how to make best use of OO.

> The Wiki page exists because the documentation project wants to
> simplify collaboration. Every registered user can edit and add pages
> on the Wiki. That's really easy on a Wiki, while it needs some more
> efforts on a "normal" web page. The contents should be the same if
> possible, just the layout looks a bit different.

Yes, that is my experience (and the source of confusion): The contents
of parallel pages appear to be the same, just formatted differently.
So, with one set of pages authored as a wiki, and a parallel set of
"official" pages more traditionally authored,
  - How are these two sets of pages kept in sync?
  - Does oooauthors.org, which feeds both sets of pages, feed both in
parallel, simultaneously?
  - Besides the documentation project, does any other project in the
openoffice.org family use this arrangement of parallel sets of pages?

Thanks again for clarifying,
John

---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@...
For additional commands, e-mail: users-help@...