Do Not Emphasize Line Headings

Context and Problem Statement

MADR contains lines such as Chosen option: "[option 1]". Should “Chosen option” be emphasized?

Decision Drivers

  • MADR should be easy to read
  • MADR should be easy to write

Considered Options

  • Do not emphasize line headings
  • Emphasize line headings

Decision Outcome

Chosen option: “Do not emphasize line headings”, because 1) these headings always are put at the beginning of a line and followed by a colon. Thus, they are already easy to identified as line heading. 2) Readers not familiar with Markdown might be confused by stars in the text.