Improving the Shared Repository Tutorial (DONE: - using more simple terms)

Jari Aalto jari.aalto at cante.net
Wed Dec 20 10:14:39 GMT 2006


John Arbash Meinel <john at arbash-meinel.com> writes:

> Jari Aalto wrote:
>> About this page:
>> 
>>    http://bazaar-vcs.org/SharedRepositoryTutorial
>> 
>> I'm not sure the tutorial is easy to follow with all kinds of fancy
>> works to have to keep in mind; like shizzle, vcoder, DrumTronics,
>> ShizzleSound et all. For non-english like me, it's hard to understand
>> what's going on and who's doing what.
>> 
>> What if the page used simple terms like:
>> 
>>     Project
>>     feature{1,2,3}
>>     fix{1,2,3} 
>>     ...
>> 
>> Any volunteers or can I go and change the wordings?
>> 
>> Jari
>
> I would like something a little bit less generic than Project and
> "feature" but it doesn't have to be 'shizzle'.
>
> For me, it is hard to keep track of when you are talking about "when
> modifying a project" versus "when modifying Project". So having an
> explicit name is actually helpful to give a handle on it, and to give it
> some context about how it might relate to other things. Though I guess
> that is more for branch names.

I've updated the page the "Drum Tronics" is not boring "foo" and the
fancy shizzle and vcoder have been replaced with more boring "feature"
:-) But I think it's much more clearer now.

Jari






More information about the bazaar mailing list