Simplified Tutorial

John Arbash Meinel john at arbash-meinel.com
Fri May 5 17:50:54 BST 2006


I've been playing around with simplifying the bzr tutorial. The one we
have has a lot of great information, but I think it is a little bit too
wordy. For people who just want a step-by-step to get up and running, I
think we could strip out a lot of stuff.

I've been sort of following Mercurial's tutorial, and the tutorial.txt file.

Attached is a rough draft of a start at something more streamlined.
I've also included a css style file. Which while not great, still looks
a lot better than the default.

To compile to html install docutils and run:
rst2html --stylesheet=default.css \
	--link-stylesheet simple_tutorial.txt simple_tutorial.html

I also published some of this at:
http://bzr.arbash-meinel.com/branches/bzr/update-tutorial

I'm happy with some of the texts, and I think my definition of
WorkingTree/Branch/Repository terms coupled with how they get used is
fairly nice. I'm guessing I don't have it in the right place in the
tutorial, but I think it helps give people a way to wrap their heads
around bzr's complexity.

John
=:->
-------------- next part --------------
A non-text attachment was scrubbed...
Name: default.css
Type: text/css
Size: 1994 bytes
Desc: not available
Url : https://lists.ubuntu.com/archives/bazaar/attachments/20060505/e416670a/attachment.css 
-------------- next part --------------
An embedded and charset-unspecified text was scrubbed...
Name: simple_tutorial.txt
Url: https://lists.ubuntu.com/archives/bazaar/attachments/20060505/e416670a/attachment.txt 
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 254 bytes
Desc: OpenPGP digital signature
Url : https://lists.ubuntu.com/archives/bazaar/attachments/20060505/e416670a/attachment.pgp 


More information about the bazaar mailing list