Guilhem Bonnefille <guilhem.bonnefi...@gmail.com> writes: > But while preparing, I discovered that a documentation system > disconnected from source code is not really easy to maintain. For > example, when we add a feature, we have to keep its documentation > waiting the next release. > So, as simple is the online wiki solution, I prefer to change this > solution for something else. The standard solution, with many > available tools, seems to be DocBook. Its format is much more complex, > but it is well documented.
Agreed in principle that something like this makes sense. The only problem with docbook is that some people think it's too hard to edit. An alternative is asciidoc, which is less powerful but easy. But if someone is willing to do the main wiki->docbook translation, it's probabbly easy enough to maintain. So I'm not objecting at all, just making an observation.
pgpWsJCNwFrGX.pgp
Description: PGP signature
------------------------------------------------------------------------------ SOLARIS 10 is the OS for Data Centers - provides features such as DTrace, Predictive Self Healing and Award Winning ZFS. Get Solaris 10 NOW http://p.sf.net/sfu/solaris-dev2dev
_______________________________________________ Viking-devel mailing list Viking-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/viking-devel Viking home page: http://viking.sf.net/
