Re: [Gnu-arch-users] new introduction to Arch with diagrams

[Zack Brown]

On Thu, Oct 02, 2003 at 11:54:19PM -0700, Joshua Haberman wrote:
> A picture is worth more than a thousands words when you're talking about
> revision control where there are branches and changesets flying every
> which way.
> 
> I have begun working on a succinct introduction to Arch's basic model
> that makes liberal use of diagrams.  I would like feedback, especially
> if any of it is false or misleading.  I am still quite new to Arch, and
> there's a lot I still don't understand.
> 
> http://www.reverberate.org/computers/arch/model.html
> 
> Right now it covers the basics of branches, archives, changesets,
> replay, and update.  As I learn more about merging between multiple
> branches I will add this information also.

Looks very useful. Have you considered using UML for the diagrams? This
has the advantage of not creating Yet Another Diagramming Format, and UML
has solved a lot of problems you might encounter if your diagrams get much
more complex. There are also programs like 'dia', which are able to draw
UML diagrams quickly.

I like the idea of adding diagrams to cover different ways of merging,
like star-merge and prism-merge. If you do end up diagram those complex
merge techniques, it would be great to have a diagram for each variation
on those themes. My understanding is that things like star-merge are
useful in a variety of different situations.

Finally, you might also diagram work patterns, corresponding to the
different ways of organizing an open source project. Most projects have
some subtleties that represent specific problems arch needs to solve in
order to work in that environment.

Be well,
Zack

> 
> Josh
> 
> 
> _______________________________________________
> Gnu-arch-users mailing list
> address@hidden
> http://mail.gnu.org/mailman/listinfo/gnu-arch-users
> 
> GNU arch home page:
> http://savannah.gnu.org/projects/gnu-arch/

-- 
Zack Brown