Hello,
I forward the mail about the documentation system, because the feedback
on the oi-dev list wasn't that much.
Maybe it would help to start a maillinglist for the documentation after
decide the basic points.
Sincerely,
Tobias
-------- Original-Nachricht --------
Betreff: Re: [oi-dev] Documentation Systems
Datum: Thu, 29 Sep 2011 21:00:57 +0200
Von: Tobias Famulla <u...@famulla.eu>
Antwort an: OpenIndiana Developer mailing list <oi-...@openindiana.org>
An: Volker A. Brandt <v...@bb-c.de>, OpenIndiana Developer mailing list
<oi-...@openindiana.org>
Hello Volker,
I added the licences of the formats and the software to the document,
after my holidays.
The old documentation of OpenSolaris is licenced under Public
Documentation Licence.
http://hub.opensolaris.org/bin/view/Community+Group+documentation/tmp
Sadly all documents I found about Solaris 11 Express are copyrighted by
Oracle.
http://download.oracle.com/docs/cd/E19963-01/
Because of this, the change of the format might not be that big issue,
because we only have to do it once.
Although other projects use DocBook with big success.
I sadly never used DocBook or DITA by myself, yet.
Sincerely,
Tobias
Am 06.08.2011 12:50, schrieb Volker A. Brandt:
Hello Tobias!
I summarized information about reStructuredText, DocBook and DITA.
This is very interesting information, thank you.
One thing that should also be investigated for each format is licensing,
both things like definitions, DTDs, etc., and the licenses of the tools.
In our company, we are using docbook + dblatex + pdflatex with very
good results. The dblatex is actively and very well maintained by
its original author.
Regards -- Volker
--
Jabber: b...@jabber.ccc.de
ICQ: 279837014
Handy: 0178-5545505
Skype: grund-rauschen
_______________________________________________
oi-dev mailing list
oi-...@openindiana.org
http://openindiana.org/mailman/listinfo/oi-dev
_______________________________________________
OpenIndiana-discuss mailing list
OpenIndiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss
