incubator-ooo-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From conflue...@apache.org
Subject [CONF] Apache OpenOffice Community > User Guides Revisted
Date Tue, 18 Sep 2012 20:53:00 GMT
Space: Apache OpenOffice Community (https://cwiki.apache.org/confluence/display/OOOUSERS)
Page: User Guides Revisted (https://cwiki.apache.org/confluence/display/OOOUSERS/User+Guides+Revisted)
Comment: https://cwiki.apache.org/confluence/display/OOOUSERS/User+Guides+Revisted?focusedCommentId=30151580#comment-30151580

Comment added by Keith N. McKenna:
---------------------------------------------------------------------

Kay, I agree completely with your assessment of Scenario 1 as well as ALL the documentation
areas needing alignment. I have looked as some of it and the sheer size of the task overwhelms
me. We as a project need to think much more deeply about Documentation as a whole and where
it fits into the project. My gut feeling is that the general feeling about Documentation ranges
from "If we avoid it maybe it will go away" to "It is a necessary evil that hopefully someone
else will worry about".

Scenario 2 is also my preferred option. I will try to elaborate in the document itself on
the Cons. Basically they have to do with the license and where they get distributed from.
My understanding is that because of license issues they would not be considered "official
documentation".

Scenario 3:
I agree but I put it there mostly for completion and to get people thinking about what the
documentation or AOO v4.x should look like.

In reply to a comment by Kay Schenk:
Scenario 1: 
Not really an option but a default. This is what we have now and I have been greatly tempted
since the release of 3.4 to link to the draft docs for AOO 3.4 at the ODFAuthors site, but
got too busy to bring this up.
(Additioanlly, all documentation areas on the web server and wiki need realignment).

Scenario 2. (my preferred option)

Please elaborate on the "cons" of this option. For example, if work continues with ODFAuthors,
where are the docs really hosted? ODFAuthors is already a well-known site for the documents.
Can we continue to view this entity as the "official" producer/host of the User Guides and
just link/refer people to them? Are we concerned about full control? Why would there be distribution
problems.

Scenario 3: 
Nice, but, why start over when a successful process (ODFAuthors) is already in existence.
Additionally, the mechanism for development would need to be determined and maintained,etc.

Change your notification preferences: https://cwiki.apache.org/confluence/users/viewnotifications.action

Mime
View raw message