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