Initial thoughts on Bzr docs

Eugene Wee eugenew at starhub.net.sg
Thu Sep 27 18:27:44 BST 2007


Hi everyone,

> Missing docs
> -------------
> 
> My main priority is to ensure that there are no major gaps in Bazaar's
> docs. You'll have seen my meeting announcement already, where I'd like
> to discuss what's missing in the docs.
> 
> However, I don't see any reason not to kick off the discussion here
> before the meetings! You guys know Bazaar much better than I do :)

I would highlight the Workflows document as something that is not 
missing, yet missing more detailed information. As a student who has 
never used Bazaar in a team, I am puzzled as to which workflow might be 
the best choice for me.

If each workflow listed comes with examples, it would be easier to 
understand just what they involve. For example, I believe java-gnome 
uses the "Decentralized with human gatekeeper" workflow, and their 
hacking doc describes how an observer might contribute:
http://java-gnome.sourceforge.net/4.0/HACKING.html

It is not clear for a newbie to Bazaar what "when a developer wants 
their work merged, they ask the gatekeeper to merge it" means, but if 
they have an example like that of java-gnome (reader: oh, the developer 
uses bzr send to ask the gatekeeper to merge it), it becomes easier to 
understand.

Thanks,
Eugene Wee

P.S.: since this is on the wiki, I might make the changes myself, but I 
am not sure how all the workflows really are supposed to work in practice.



More information about the bazaar mailing list