Contents > F: Glossary

F: Glossary

Completeness
Design rules of the "Completeness" category raise issues that hint at incomplete design. This highlights model elements that still need some work. For example, empty packages, unused classes, unnamed attributes, parameters without a type, etc.
Correctness
Design rules of the "Correctness" category raise issues that constitute illegal design. For example, violation of well-formedness rules (WFR) of the UML.
Diagram
Diagram metrics pertain to the diagrams of the UML model. There are two types of diagram metrics:
  1. Diagram metrics that count how often a class, package, etc. appears on the diagrams in the model. Similar to export coupling, the more often a model element appears on diagrams, the more important is the role of the model element.
    You may also look out for elements which do not appear on any diagrams. This could indicate that the diagrams are not complete, or they may be the result of an incomplete delete operation.
  2. Metrics that count the number of model elements on a diagram. These measure the size of the diagram. You may consider reorganizing large diagrams into several smaller ones, e.g., based on the 7 +/-2 rule of the amount of information that people can deal with at a time [Amb03].
On a technical note, many UML modeling tools use a proprietary solution to store diagram layout information in the XMI file. If you do not obtain diagram metrics for your model, you need a special XMI transformation file. Check the SDMetrics website if there is one available for your UML tool.
Naming
Design rules of the "Naming" category raise issues concerning the names assigned to model elements. For example, adherence to naming conventions for capitalization, use of keywords in element names.
Severity
The severity of a design rule indicates how critical a violation is. The rules distinguish three levels of severity:
Style
Design rules of the "Style" category raise design issues that are considered bad practice. While these issues do not indicate illegal design, they may be detrimental to system quality in the long run. For example, circular dependencies among packages, a class referencing one of its subclasses, long parameter lists, etc.
WFR
Well-formedness rules. The UML standards [OMG03] [OMG05] define a set of well-formedness rules, or constraints, that any valid UML model must comply with.