On Sat, 2010-12-04 at 09:17 +0530, Narayan Aras wrote: > > IMO for the first release of LibO, ideally we would have PDFs and > > printed books available, as well as info on the wiki. Started from the > > ODTs is the fastest way to do all of that. For future releases, the > > method could be quite different. > > > > --Jean > > Thanks Jean for bringing out this perspective. > > Yes, I agree: If the Libo docs are adopted from the well-formed docs of OOo, > then there is no point in wikifying. > And I doubt if we will need any additional documents (because OOo already had > a full set, from where we are starting off).
OOo does not have a full set of user guides. The Base Guide has only 3 chapters in draft (which IMO need a LOT of editing), with another chapter being worked on. That could be a good book to try out the wiki for writing & reviewing. LibO could take the lead on that book. > > Well, that's valid only the current version: If Libo is to be "extensively > re-written for contents, and not features", we may need new docs. > Then using a wiki makes sense for a fresh document. > > ****** > Another important thing to note: All of us agreed that OOo cannot easily > export an odt file to wiki. It works better than going the other way, unless there are tools that can handle layout complexity (see my response to your other note). > > Does it not strike you as a valid development target for LiBo? It's valid. If the problems of output from wiki and editorial change tracking can be resolved, AND if those interested in contributing to documentation (and skilled enough to do a good job) are willing to do the work on the wiki, then it could work well. --Jean > LiBo should excel in this area; because wiki (and web in general) will touch > many more lives in future! > > What is a software if it cannot resolve the pain points of its own help > authors? > > Please pass on the word to Charles Schulz! :) > > -Narayan > -- Unsubscribe instructions: E-mail to [email protected] List archive: http://www.libreoffice.org/lists/documentation/ *** All posts to this list are publicly archived for eternity ***
