Secondary notation

Secondary notation is the set of visual cues used to improve the readability of a formal notation. Examples of secondary notation include the syntax highlighting of computer source code, sizes and color codes for easy recognition of consumer symbols such as bank notes or coins, or the regular typographic conventions often found in technical books to highlight sections with the same type of content.

Secondary notation provides redundant (more than necessary) information; if the visual cues are the only way that some information is provided, such as in traffic lights, or a chart's key, it is not secondary. Secondary notation is often not a part of the formal notation itself. Rather, it is a method of organizing the formal notation to allow it to be more easily understood. Thus, secondary notation does not change the actual meaning of the formal notation, rather it allows for the meaning to be readily understood. In text such as programming languages, this can be done using cues such as indentation and coloring. In formal graphical notations, this can be done through the use of symmetry or proximity to indicate relatedness.

In different contexts

Secondary notation annotates formal notation in a number of contexts which can be broken down to two main domains: text and graphics.

Textual context

There are a number of common instances of secondary notation that are seen in text. Secondary notation is common in typography and in code editors appearing as boldness, italics, and spacing/indentation.

Textual secondary notation in computer source code

Secondary notation in the form of coloring and indentation is commonly implemented in integrated development environments to make source code more readable and make the formal notation more understandable. The following C source code does not use secondary notation to ease the interpretation of the formal notation:

int main(){while(true){printf("I'm stuck in an infinite loop!");}}

The following is the same code, but with indentation and syntax highlighting. As a result, the formal notation of C is easier to read:

int main() {  while (true) {  printf("I'm stuck in an infinite loop!");  } } 

Textual secondary notation in typography

A number of examples of secondary notation that commonly appear in English writing include

• Boldness which is used to put emphasis on a certain area of text.
• Italics which is another method of applying emphasis on a certain area of text.
• The following example effectively uses indentation to separate items on a shopping list that must be bought at different stores. Indented items all must be bought at the store within which the items are nested.

 1. Allison's Frozen Foods  - Frozen Tuna  - Chicken patties  - Fish sticks  - 2lb of hamburgers    2. Sarah's Groceries  - 3 boxes of cereal  - 2 boxes of fruit juice  - 2 dozen eggs    3. Jim's Formal Wear  - 2 dress shirts  - 1 orange tie 

Graphical context

Secondary notation is commonly used in graphical contexts to better convey information beyond what the formal notation of the graphic makes explicit.

Flowcharts

 

This is a well drawn model of the steps a user would take to place an order for some products on a website.

 

This is a poorly drawn model of the steps a user would take to place an order for some products on a website.

A graphical representation that has been well studied and can be heavily impacted by secondary notation is a flowchart and especially drakon-charts. Research has shown that there are a number of layout factors unincorporated into the formal notation that impact a flowchart's ease of understanding:

1. Minimize arc crossings: the number of times lines cross should be kept to a minimum to ease traceability. In drakon-charts all the arc (line) crossings are forbidden.
2. Minimize line bends: additional bends add to the visual complexity of the model. In drakon-charts all the line bends are minimized.
3. Leverage symmetry: position elements symmetrically when possible
4. Align labels horizontally: textual labels are easier to read when aligned horizontally
5. Use of locality: group related items together to be easily recognizable

The examples on the right show how these techniques can drastically affect the ease of understanding when looking at a process model. The model depicts a simplified process for ordering products from a website. Both diagrams contain exactly the same blocks with the same interconnections. However, the one that uses better secondary notation can be readily understood whereas the other model requires careful analysis to understand its contents.

Misuse

While inadequate use of secondary notation can significantly increase the amount of effort necessary to understand a model, misuse of secondary notation can also be a detriment. Use of symmetry can make a graphic more visually appealing, but can also convey misconceptions if used incorrectly. For instance, placing unrelated items close together may cause a reader to perceive them as being related. Additionally, arbitrary use of coloring may distract a reader as they wonder about the meanings of the various colors.

Experts vs. novices

The ability of individuals to understand and use secondary notation has been shown^{[citation needed]} to vary based on experience within the relevant field. Experts in a field are generally more able to utilize the clues provided by secondary notation. Specifically, while reading diagrams, experts have been shown to have more skill at reading the larger structure of the diagram and using it to guide their examination of the details provided by the formal notation. This compares to novices who often focus on the details of the formal notation, ignoring the hints provided by the secondary notation.

There are also differences based on level of experience/expertise when creating documents that utilize secondary notation. Experts tend to be more consistent in their use of conventions while novices tend to vary between conventions, sometimes adhering on a surface level, but failing to convey the desired information. In the case of circuit diagrams, this is illustrated by common novice mistakes such as creating visual symmetry where there is no logical symmetry and frequent transitions between differing secondary notation conventions.

As part of formal notation

In some cases, secondary notation is part of the formal notation. Such formal notations attempt to improve readability by enforcing the presence of visual cues. The trade-off is that, what in many other cases is only secondary notation (like, for example, indentation in free-form languages), is now part of the formal notation, and thus is not optional.

For example, the Python programming language requires source code to follow strict indentation rules. This is intended to improve readability of the code, by ensuring that statements that are at the same level of nesting within a block are aligned to the same column. Other types of secondary notation, however, are not part of the formal notation.^[1] For example, when wrapping long lines, every line that is a continuation of a previous line can be indented arbitrarily.^[2]

if x == 1: print("x is 1") print("x is odd") print("This is always printed") # this is illegal print("Hello world") str = " ".join( "these words are indented", "for better readability") 

Markdown also uses indentation as part of the formal syntax of the language. Indentation is required in Markdown when creating certain source code representations of block quotations as well as when creating sections of source code to be rendered as the code itself.^[3]

#Heading 1# #Indented Markdown source code that will be rendered as source code# 

See also

• Cognitive dimensions
• Syntax highlighting
• Syntactic sugar

Notes

1. "Python: Myths about Indentation". www.secnetix.de. Retrieved 2017-05-22.
2. "PEP 8 -- Style Guide for Python Code". www.python.org. Retrieved 2017-05-22.
3. Gruber, John (2015-04-19). "Markdown Syntax". Daring Fireball. Retrieved 2015-04-19.

References

• Green, T. R. G.; Petre, M. (1996). "Usability analysis of visual programming environments: A 'cognitive dimensions' framework". Journal of Visual Languages & Computing. 7 (2): 131–174. doi:10.1006/jvlc.1996.0009. S2CID 11750514..
• Marian Petre, Why looking isn't always seeing: readership skills and graphical programming.^{[permanent dead link]} Commun. ACM, 38(6):33-44, 1995.
• Marian Petre, M. Petre. Cognitive dimensions 'beyond the notation'. J. Vis. Lang. Comput., 17(4):292-301, 2006.
• Rule, Revisiting Landin’S. Offside, and Michael D. Adams. "Principled Parsing for Indentation-Sensitive Languages." (2013).
• Schrepfer, Matthias; Wolf, Johannes; Mendling, Jan; Reijers, Hajo A. (2009). "The Impact of Secondary Notation on Process Model Understanding" (PDF). The Practice of Enterprise Modeling. Lecture Notes in Business Information Processing. Vol. 39. SpringerLink. pp. 161–175. doi:10.1007/978-3-642-05352-8_13. ISBN 978-3-642-05351-1. Retrieved 2011-07-12. {{cite book}}: |work= ignored (help)