Simplified Tutorial

[John A Meinel]

Matthew D. Fuller wrote:
> On Sat, May 06, 2006 at 08:39:01AM -0500 I heard the voice of
> John Arbash Meinel, and lo! it spake thus:
>> Well, I used branches with CVS, but I know a lot of people didn't.
> 
> Oh, I have too.  But not in most projects.
> 
> 
>> I would probably recommend switching your focus from standalone
>> branches, into heavy checkouts with a remote repository.
> 
> Well, you'll note that the (yet unwritten) third part is intended to
> discuss centralized multi-user development, using a pattern like
> 
>     (roughly, star-config bound branches, except without the bound
>     since 0.7 doesn't have that)
> 
> So, if finished out then for 0.8...    8-}
> 
> 
>> They can always grow into more.
> 
> I'm intentionally fighting very hard to NOT do that; you slip very
> quickly from the "use bzr" to "what bzr can do" section, and that's a
> "next steps" or "evangelism" piece, not a tutorial.
> 

I'm not saying to expand your tutorial. I'm saying that users can start
with a limited set. And the *users* can learn more as they go.

> 
> This perhaps calls for some expansion.  All this is strictly IMAO, of
> course.
> 
> When I read a tutorial, I feel bound to read the whole thing, front to
> back, because there are always side notes and gotchas that can save me
> a lot of time.  And also, because I assume that if it's in there,
> it'll be there because I need to know it.  If I come out the far side
> and can't remember the commands discussed in enough detail to almost
> use them in simple cases, it's a failure[0].

Well, I think you broke it up in a reasonable grouping. With 'SimpleBzr'
first, and then growing from there.

John
=:->

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 249 bytes
Desc: OpenPGP digital signature
Url : https://lists.ubuntu.com/archives/bazaar/attachments/20060507/b6742ed4/attachment.pgp