# Maintenance of feature structure

Writing style of documentation files,
coding style of scripts,
and how to handle translation, preview, and compilation.


## Documentation

Texts are written in [CommonMark][] -
a strict flavor of Markdown.

Use short [ATX headings][],
and [semantic linewrapping][].

Use [reference links] -
in shortcut style where possible,
with its reference definition at bottom of same section.

Avoid [hard line breaks][].

[CommonMark]: <https://commonmark.org/>
  "CommonMark - strongly defined, highly compatible specification of Markdown"

[ATX headings]: <https://en.wikipedia.org/wiki/Aaron_Swartz#Markdown>
  "ATX headings - header markup using leading hashtags"

[semantic linewrapping]: <https://scott.mn/2014/02/21/semantic_linewrapping/>
  "semantic linewrapping - wrap by paragraph or shorter semantic chunks"

[reference links]: <https://spec.commonmark.org/0.28/#reference-link>
  "reference links - link markup with metadata in separate source paragraph"

[hard line breaks]: <https://spec.commonmark.org/0.28/#soft-line-breaks>
  "hard line breaks - markup to force linebreak within a paragraph"