Decisions

One record per choice that shapes this repository. Each follows the decision record of reader-ergonomics: the decision in one sentence under its title, then its status, context, decision and consequences.

Shape: topic, as the filled example the shape points to.

Contents

Record	Summary
0001 Call the unit a topic	the unit takes the word of DITA and topic-based authoring
0002 Three reviews	one review per part of the template, each work reviewed once in the family
0003 Link the shapes, never move them	reader-ergonomics stays untouched; the fit is shown from this side
0004 Every document is a topic	the repository is its own first tree of topics, checked in CI
0005 Revise after the held-out test	metadata before the summary, labelled summaries, typed children
0006 Move to reader-ergonomics v1.1.1	the pin moves to the standard's new release
0007 Derive the decision records from the topic	the first derived shape, used and checked here
0008 Move to v1.2.0, drop the local quote check	the standard now carries the check, kept strict here
0009 Follow the standard's decision record	the shape moved down to reader-ergonomics v1.3.0
0010 Move to reader-ergonomics v1.4.1	the standard now checks figure widths and shrinks figures on a phone
0011 Move to reader-ergonomics v1.9.0	the standard now checks keys, records, shape examples and drawn figures
0012 The AI-augmented topic, as an extension	the topic's extension, joined to master once its review named B1; superseded by 0016
0013 Move to reader-ergonomics v1.11.0	the standard now checks the drawn figures: typed, alt, source, contrast
0014 Move to reader-ergonomics v1.12.0	every workflow now checks out the standard at one commit, checked
0015 Move to reader-ergonomics v1.13.0	every link into the standard now names the pinned commit, checked
0016 Move the AI-augmented strand out	it leaves with its history for a repository of its own; the topic keeps its template, check and three reviews

See also

The repository's front page, the parent of this folder.