# Decisions

One record per choice that shapes this repository. Each follows the [decision record](https://github.com/Tewf/reader-ergonomics/blob/bfbe9f7ed27bfdca0c6a4922d0b3e302f9e55d3f/shapes/decision-record.md) of
reader-ergonomics: the decision in one sentence under its title, then its status, context, decision and consequences.

**Shape:** [topic](../shapes/topic.md), as the filled example the shape points to.

## Contents

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