On Sat, 2010-10-02 at 21:44 -0500, Nancy Ward wrote: > On 10/2/2010 9:01 PM, Jean Hollis Weber wrote: > > Many people will continue using OOo 3.2 (or earlier) for some time after > > 3.3 is released. A few things (the Print dialog, slide creation in > > Impress, probably others) are so dramatic that if we simply update the > > user guides to OOo3.3, they won't serve the needs of 3.2 users. > > Therefore I think we should include both sets of instructions, clearly > > marked for the relevant version of OOo. (And leave the earlier info out > > of the LibO version of the docs; a good use of a conditionally hidden > > section.) > > > > The other choice is to produce an updated chapter and keep the old > > chapter as well, but I don't think this is a good idea because people > > are likely to grab the wrong version of the chapter... and it's just one > > more thing for us to keep track of. > > > > I'm not suggesting this approach for all the changes, just the major > > ones. BTW, in the past we've included note-like tables saying "New in > > [version]" but that's only useful for NEW not CHANGED features. > > > > Comments? > > > > Jean > Since 3.2 to 3.3 doesn't qualify as an upgrade, only as an update, it's > not feasible to publish a complete new manuaI. Therefore, pretty much > the only thing to do is to include both sets of instructions, clearly > marked for the relevant version. And yes, the older instructions should > be left out of LibO since I gather the project begins here. > > Nancy Ward
I've been thinking about this some more. (1) Our published books are current for v3.2 (except for the Impress Guide, which Michele Zarri just uploaded part of today). (2) We WILL be publishing "complete new guides" because of OOo rebranding and other planned changes to correct errors, add missing info, and improve explanations. (3) The question is: will we make these new guides cover V3.3 only, or include both V3.2 and V3.3 info as I described in an earlier note? (4) If make the new guides for V3.3 only, then instead of replacing the old guides, we should keep the V3.2 books and have both available. This would work easily for the ODT/PDF editions, but perhaps not so easily for the wikified version (which has other problems as well, as discussed on a separate thread). Sorry to spend so much time thinking aloud on list, but quite often some of you come up with pros and cons that I hadn't thought of -- and on principle I prefer to be collaborative until the time comes for an executive decision if no consensus emerges. :-) Jean -- Jean Hollis Weber Co-Lead, OpenOffice.org Documentation Project --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
