Re: [Viking-devel] Viking's documentation

[Greg T. <gd...@ir...>]

Guilhem Bonnefille <gui...@gm...> 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.