[oi-dev] Fwd: [OpenIndiana-discuss] Documentation-Project

[Volker A. Brandt]

> Iirc, Sphinx supported export to a variety of formats.  Since
> documentation is something developers are historically far less keen on
> than writing code and we've got someone interested stepping up and
> contributing in this much neglected capacity, barring any technical
> reasons to the contrary, my vote would be to give Tobias the thumbs up.

Having glanced at the Sphinx web site, it is not obvious to me if
there are options to generate docbook output.  Sphinx seems very
Python-centric to me, which I'd rather avoid.

Of course when Tobias does the work he gets to decide what tool to
use.  I'd feel better if all the time and effort spent on the content
can be reused when the documentation is re-tooled to something more
common, like docbook.


Regards -- Volker
-- 
------------------------------------------------------------------------
Volker A. Brandt               Consulting and Support for Oracle Solaris
Brandt & Brandt Computer GmbH                   WWW: http://www.bb-c.de/
Am Wiesenpfad 6, 53340 Meckenheim                     Email: vab at bb-c.de
Handelsregister: Amtsgericht Bonn, HRB 10513              Schuhgröße: 46
Geschäftsführer: Rainer J. H. Brandt und Volker A. Brandt