Guideline: General Modeling Guidelines and Drawing Conventions
This guideline describes general naming and drawing conventions for all diagrams.
Create simple, focused diagrams with a small number of elements. As a rule of thumb, avoid placing more than ten
major elements (block, use case, actor, etc.) on a diagram.
Ensure all diagrams can be printed on standard 8.5x11 paper.
Arrange elements in diagrams to avoid crossing of lines. All lines should be straight or rectilinear.
Create elements with a consistent size. Avoid clutter and chaos by arranging elements with equidistant spacing and
alignment.
The default tool fonts, shapes, symbols, line styles, and colors shall be used consistently in all packages in
the model.
Position related elements close together in diagrams.
Ensure elements in diagrams have the same level of abstraction.
Organize diagrams in a hierarchical fashion. Locate diagrams in packages corresponding to their relative position
in the system hierarchy.
Ensure accurate and complete descriptions are entered for all model elements to assist in understanding the model
and to facilitate the eventual hand-off of the model. These descriptions must also support the auto-generated
documentation from the model.
Avoid excessive use of description notes in diagrams. It's generally recommended to put these descriptions in the
description field of the corresponding graphical artifact