Gary, > Even a simple Para element lead-in could be used for that, but having > available an additional style/tag/element is preferable. Besides, the > online help segments are usually way too short for having many > lower-level sections--or is already a lower-level section.
I don't see the advantage of having another element for this purpose instead of just using a simple paragraph and including that requirement in the style guide. In the long run, I would like to see the help content maintenance going to the wiki and we wouldn't be able to control a rigid structure on a wiki page, anyway. > And what might be used in OOo docs for the kludging run-in subheads as > commonly used in FrameMaker, InDesign, etc? Using a character > style--Strong emphasis, perhaps--for the introductory word(s)? > > And how come OOo doesn't seem to use the ubiquitous DocBook, which was > specifically invented for documenting software? When the help moved to open source in 2002(?) we considered using Docbook but decided against it mainly for two reasons: 1 Docbook suffers from element proliferation and is far too complex for the purpose of the help 2 Docbook is focussed on a book paradigm and less suited to represent data in a more modular web-like fashion. For this purpose, DITA would be a more promising approach. Hence we decided to specify our own, simple DTD, in a somewhat ad hoc fashion to also support the migration from the old format. 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]
