On Aug 31, 2013, at 7:46 AM, Tom Browder wrote:
> Maybe we should reorganize the doc/docbook directory a bit to emphasize and
> ease the job of selecting style sheets by DocBook type. Change doc/docbook/
> subdirs from:
I agree that there's very little difference between articles, lessons, and
(chapters of) books. In fact, I see books as being collections of other
documents (articles, lessons, manpages), with distinct structural needs (TOC,
appendices, indices, ..). I'd think most presentations, however, are
dramatically different (in terms of content).
I can see the argument for specifications and man pages (system) falling under
books, but their content is more strict (must have various sections, synopsis,
etc). I also generally expect a specification document to have a style
substantially different, similar to an academic research paper -- which is yet
another unrepresented category (though they might work as an article).
Cheers!
Sean
------------------------------------------------------------------------------
Learn the latest--Visual Studio 2012, SharePoint 2013, SQL 2012, more!
Discover the easy way to master current and previous Microsoft technologies
and advance your career. Get an incredible 1,500+ hours of step-by-step
tutorial videos with LearnDevNow. Subscribe today and save!
http://pubads.g.doubleclick.net/gampad/clk?id=58040911&iu=/4140/ostg.clktrk
_______________________________________________
BRL-CAD Developer mailing list
brlcad-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/brlcad-devel
