Documents, in bzr or wiki

[Erik Bågfors]

Hi

Just a thought, having the documentation on the wiki has been very
good from a "let's get lot's of document done", but it's gotten to the
point where lot's is out of date, for old versions, etc.

The problem with the wiki is that some document has to say "this is
supported in 0.8 and up", "this is how you do it pre 0.8, this is
post", etc.  This will only get worse. It's also very adhoc, people
write what they think is important.

I would like us to create a new manual with a good structure, real
thoughts on what should be included, and that should include
tutorials.  I really find the darcs manual easy to use.
http://www.darcs.net/manual/bigpage.html.  I also think that the
documentation should be in the bzr branches, so that we can keep them
up to date with the version in the branch and not with all versions
out there.

I think bzr is mature enough to make documentation a very important
thing right now.

What do people think?

/Erik