Re: Subtle improvement to sequence diagrams....Re: Web based sequence diagram generator

John, that's a really great idea. Concurrency isn't really something
that's emphasized with these types of diagrams, but it impacts every
system and causes bugs. I've added it to the list of things to do.

Also last night I added styles, so the output can look like rose,
quick sequence diagram editor (qsd) or mscgen. You can also do object
activation, deactivation, and destruction.

On Mar 27, 1:20 am, John Carter <john.car...@xxxxxxxxxx> wrote:
On Mon, 26 Mar 2007 16:30:03 -0700,steve.hanovwrote:
I made this because I have to draw a lot of sequence diagrams at work, for
documentation. We have special MS Visio templates for UML but they are not
fun to use.

Now I just type into my tool at:

http://gandolf.homelinux.org/~smhanov/mscdraw/index.php

Then it spits out the image, which I copy and paste into my documents.

Cool!

Suggestion...

Make the horizontal event lines with a gentle downward slope...

Instead of...

|--------------->|

Something like so (but perhaps a gentle 20 degrees instead of the
45degrees forced by ascii art)...

|\ |
| \ |
| \>|

Why? Because its a gentle reminder about the speed of light and latencies
in communication systems.

When people draw horizontal event lines they mistakenly think the creation
of the event and the reception of the event is instantaneous.

When the lines are gently sloping it reminds you... Hey! Between the left
of the arrow and the right, is a space of time during which another arrow
may be coming back at me....

|\ /|
| \ / |
| X |
| / \ |
|< >|

And whenever I can draw a diagram with crossing event lines like that, I
know I have a rich and fertile soil in which to go hunting race conditions
and deadlocks.

And boy oh boy whenever I have gone looking, I have many such subtle bugs
in the code of those who draw event lines horizontally!

--

John Carter Phone : (64)(3) 358 6639
Tait Electronics Fax : (64)(3) 359 4632
PO Box 1645 Christchurch Email : john.car...@xxxxxxxxxx
New Zealand

.

Relevant Pages

  • Re: class diagram question
    ... > draw a link between those classes in my class diagram or do I only need to ... > aClassOfMine is an instance of a self-written class and MyClass is another ... Interaction Diagram for any behavioral collaboration between different ... swimlanes with a specific object identifier. ...
    (comp.object)
  • Re: Hey, Jobst, on p39 of The Bicycle Wheel the graph appears to show the ?impossibility of...
    ... On a drawing with the scale of Jobst's figure, ... small displacements either side of zero. ... What's confusing about the diagram is that it's showing a different ... and because the left lateral force line is drawn ...
    (rec.bicycles.tech)
  • Re: DCC occupancy detections false positives
    ... Could you perhaps draw up a version in Paint that could be posted somewhere? ... The four ordinary diodes on the left are most easily found together in ... short out the rectifier's `+' and `-' terminals ... the diagram at that link looks better. ...
    (rec.models.railroad)
  • Re: Hey, Jobst, on p39 of The Bicycle Wheel the graph appears to show the ?impossibility of...
    ... that is actually a graph of. ... Actually I did say I would draw the diagram differently in the sense ... After numerous posts apparently criticising the drawing, ...
    (rec.bicycles.tech)
  • Re: Rigid rod problem
    ... >>that sense it's not a surprising result at all. ... >>diagram and, say, pick some point on the leftmost ... >>hyperbola and draw the tangent there. ...
    (sci.physics.relativity)