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