The last detail to discuss about the
is comments. Here is an example.
Two things require an attention here. The first one is the condition
side comment. The side comment needs to be aligned with the condition lines so it has
to be exactly to the right of the decision block. On the other hand there is a connector
of the branch at the right which will be crossed by the side comment one way or another
while it definitely would be better to avoid any kind of crossing. So a tough decision was
made: there will be crossing connectors and the comment connector will be drawn shifted down.
A mitigating factor to this decision is that the side comments for the
statements are rare.
The second detail is the
else leading comment.
else keyword in the text editor corresponds to a connector in graphics
else leading comment becomes looking exactly as an independent one.