Jean Hollis Weber wrote: > Earlier, Frank asked whether the source for the OOoAuthors books would > be the wiki in future. This was in the context of perhaps combining > those books with the "official" User Guide on the wiki. > > I asked on the OOoAuthors list for people's preferences on keeping the > source as ODT or wiki. So far everyone who has expressed an opinion > (including translators) has been in favour of ODT. > > This preference is not surprising, because the people working on > OOoAuthors material are self-selected to be people who want the main > output to be books.
I replied to that list that I understand the reservations. We need to work on the wiki some more to shape it up to be able to fulfill the requierements. I will work on that. > I am thinking that Alan's comments about the most efficient use of > resources may be superceded by questions like: who is available to work > on documentation, what type of documentation do they want to work on, > and what formats do they feel comfortable working on? Will the people > who prefer the wiki actually produce more documentation than those of us > who prefer ODT? I don't know the answer to that. Nor do I. At least for some doc types the wiki approach seems so much more convenient that we should give it a try. We already shifted the FAQs to the wiki and I would like to look at the Howtos next. Anything that is sufficiently modular. Within the next weeks, I will put the OOo Administration Guide to the wiki (it just passed SUN's open sourcing legal treadmill) and use that, together with the API Guide which will follow a little later (still in the treadmill), as guinee-pigs for working in the wiki and publishing books. I find that exciting (I really do :-) > I do know that we at OOoAuthors have produced a lot of good > documentation (not perfect, and not as up to date as we would like, but > it's there and it's being translated into several languages) and we are > continuing to do so. > > Further, I suspect that at least some of us who prefer ODT will choose > not to make the switch to the wiki, regardless of what OOo Docs decides > to do, and therefore some of us won't directly contribute to that effort. Sure. TIMTOWTDI ;-) And there is never a one size fits all solution. As long as we work in a somewhat coordinated fashion that's perfectly fine for me. > Lastly, I think that producing documentation for an office suite in any > other format than its own is not a good advertisement for the product. > By all means, have documentation on the wiki, but produce at least some > of it using the product itself. Perhaps the "some of it" should be the > OOoAuthors books. It would also be a good advertisment including ODF and OOo in a larger authoring environment showing the beauty and potential of working with ODF-XML in a automated, scripted fashion. Frank -- Frank Peters, Documentation Project Co-Lead The OOo Documentation Project: SIGN UP - PARTICIPATE - CONTRIBUTE IT'S FREE! NO OBLIGATIONS! http://documentation.openoffice.org http://wiki.services.openoffice.org/wiki/Documentation --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
