user guide help (definitions of terms)
Ian Clatworthy
ian.clatworthy at internode.on.net
Wed Aug 5 15:46:19 BST 2009
Philippe Lhoste wrote:
> But after posting, I found out that more complete definitions are on
> their own pages, linked from there. So I leave as this for now.
> Perhaps I will do someday a page with medium descriptions I collected,
> covering the most common terms (revision, branch, repository... and
> related: snapshot, changelist or changeset, etc.).
>
> Acquiring/using the right vocabulary is one of the difficulties of using
> properly a VCS (at least for me). That's why I collect words of wisdom
> from this list... ;-)
I'm pretty keen to see a glossary added to the pending-new-look core
docs, but I'm not going to have time to put a patch up for that, nurse
it through the review process, etc. Perhaps yourself or another
community member could consider taking that on?
For motivation, see http://doc.bazaar-vcs.org/bzr.dev-html/contents.html
and imagine having the Glossary link being a page, not a link to the
wiki. That's cooler for many reasons:
1. glossary terms will appear in the search
2. users downloading the doc onto their PC will have it offline
3. the glossary is a key candidate for community folk helping making
our docs available in multiple languages.
Any volunteers? (And yes, starting small is fine.)
Ian C.
More information about the bazaar
mailing list