Short, task-based bzr doclets for real-world use cases.

[Karl Fogel]

John Arbash Meinel <john at arbash-meinel.com> writes:
> If I can give one recommendation to start with, can you use ReST for the
> documentation, rather than Moin syntax? Our wiki supports both. I'll go
> ahead and convert over the couple of ones that you've done so far. The
> big reason is that it is consistent with our internal documentation, and
> means we can just grab the wiki page and paste it into a file if we want
> to move it to being bundled with the rest of bzr.

Sure, no problem.  I've never used ReST, but it's "ReStructured Text"
format, right?  (Not to be confused with "REST".)  Can't be too hard.

> I hate to nominate someone else, but I'll have to say that so far Ian
> has been doing a great job on refining our documentation, and would
> probably fit a good role as "editor". It is certainly up to him if he
> wants to take the job. I'm just giving him credit for what we have done
> so far.

Ian, are you up for it?

I don't think you'd have to write the documents, just review and edit
others' contributions.  (Anyway, as far as writing new text goes, you've
got your hands full with the Users Guide plans :-) ).

-Karl