> [mo] This same point about cross-referencing the > detailed style guide came up in an offline > conversation today also, so +1 for this idea. We > talked about a style quick start that has pointers to > the details in the Big style guide, so we'll keep > that in mind.
Excellent, thanks. > > My big difficulty with DocBook was not the writing > > (never even got much time to produce a document). > > [mo] Uhg, that is exactly what we hope to avoid. > :( Cool. From an offline with Steven, this sounds like it will be a little different (and perhaps easier) than my previous experience. > [mo] Understood, I agree that we need to make some > recommendation about a *set* of tools to use. DocBook > has been mentioned by the community in earlier > threads and we got some comments from Frank yesterday > about Solbook, so the discussion is still ongoing. I suspect this may take a little to get hammered out. I will "await with bated breath". > Good point, hopefully we can determine a limited set > of choices and be sure to provide branching > instructions for each set. That will be wonderful. It may be helpful to flag easy-to-install tools (like Blastwave/SunFreeWare packages). > > View using Sally. Rinse, lather, > > repeat." > > That Sally, she's got eagle eyes :) Carrots. Lots of carrots. You didn't think she had red hair because she's Irish, did you? > This is great input to the process we'll create for > doc collaboration! Thanks for the detailed > descriptions ...and the humor :) You're welcome. I figure comments are better when they're clear. I'm also glad I'm able to inject some levity into the discussion, as twisted as my humour can be sometimes. :-) > I feel like there will be two > pieces coming out of this now: > > -a short version of editorial style information that > points back to the big style guide > > -a slide show/tutorial for getting tools set up that > also points back to the 'Writing for DTD' chapter > (still to be written) in the big style guide That sounds excellent. Thanks for listening. :-) I'll look forward to seeing them, and maybe getting further through the Style Guide this weekend. Rainer This message posted from opensolaris.org
