Bazaar Developer Guide (Proposed)

Eugene Wee eugenew at starhub.net.sg
Wed Apr 11 16:19:02 BST 2007


Hi,

I am actually working on a guide for novice users. Part of my motivation 
is that my fellow university students are blissfully unaware of the 
benefits of a version control system when they code. (The other part is 
that I am at the end of a technical writing module, and I figured that 
practice makes perfect :P )

Like you, my experience as a user is still pretty fresh. My aim is to 
make it more of a training manual that guides from scratch, with the 
possibility of converting it into a CHM file for Windows users. Would 
you be open to this possibility? I am not too sure how to retrofitit for 
the wiki and at the same time keep updates for a CHM file.

Regards,
Eugene Wee


Ian Clatworthy wrote:
> All,
> 
> As I'm new around here and the questions/issues I had getting started 
> with Bazaar as both a user and developer are still fresh, poolie and I 
> felt it would be beneficial to cash in on my ignorance and put together 
> some better doc, before I get too close to the internals. My general 
> thinking is that reference doc ought to be managed as part of the code 
> base but tutorial style docs are better done using Wiki technology.
> 
> Following this train of thought, I'd like to move the contents of 
> HACKING into a Developer Guide on the Wiki. I'd also like to consolidate 
> the various Wiki pages covering related material into this. A first cut 
> at a Table of Contents can be found here: 
> http://bazaar-vcs.org/IanClatworthy/ProposedBazaarDeveveloperGuide.
> 
> If there's broad agreement on this approach and the result turns out as 
> I hope, I'd like to do something similar for a User Guide, replacing the 
> skeleton BzrBook page on the wiki. That's a whole different can of worms 
> though so I'd to get the Developer Guide sorted first.
> 
> All feedback welcome.
> 
> Thanks,
> Ian C.
> 




More information about the bazaar mailing list