Skip to content

v0.9.3

Choose a tag to compare

@github-actions github-actions released this 14 Nov 15:55
· 11 commits to main since this release
30c15a6

Added

  • A draft state for a lab: status: draft in lab.yaml (#369). Optional,
    published by default, so no existing catalog changes. A draft lab is left
    out of list-labs (shown, marked "draft", with the new list-labs --drafts),
    of next and start, of course (unless the new course <id> --drafts) and
    of progress. Its attempts are neither exported nor pushed, and
    export --lab <id> refuses it. run, check, submit and show still
    accept it by its id, with a line saying it is a draft. validate-structure
    validates it like any other lab, and flags an unknown value, which behaves as
    published, as feedback does. scores is unchanged: it is the local
    history of what was played. list-labs --json and show --json carry
    status for every lab, an additive field. Documented in docs/contract-v1,
    docs/machine-output and schemas/lab.schema.json.

  • A draft state for a catalog: draft: true in the packaged manifest.
    catalog list and the welcome screen no longer offer such an entry;
    catalog list --drafts shows it, and catalog add <url> or <id> still
    installs it. catalog list --json carries draft for every known entry.
    certificats goes back to draft until it publishes a lab.

  • doc_url and criteria[].lessons are translatable in lab.<lang>.yaml.
    A lesson exists in each language of the site at a URL that cannot be derived
    from the other, and a lab had a single doc_url: guide sent an English
    learner to the French page. lab.yaml now carries the English URLs, as it
    carries the English title, and lab.fr.yaml may give the French ones;
    guide, show and list-labs --json give the URL of the session's language,
    and a translation without them inherits the English ones. validate-structure
    checks the form of every URL a translation substitutes, without counting an
    inherited one twice, and --check-urls queries translated doc_urls too. No
    existing catalog changes: a lab.yaml that keeps its French URL behaves as
    before.

Fixed

  • The engine documentation said two false things. lab.<lang>.yaml
    overrides the label of each criterion too, not only title and
    description; and in docs/machine-output, dsoxlab status gives the state
    of a lab, while host reachability is dsoxlab infra status.

  • scripts/gen-catalogues.py refuses a manifest entry that publishes no lab,
    unless it is a draft.
    Version 0.9.2 measured certificats at zero labs,
    left it out of the README table, and let catalog list offer it to learners
    anyway. Such an entry is now a discrepancy (exit 1), with a message that says
    to mark it draft: true or remove it. A draft entry is measured, stays out of
    the table even with labs, and is never reported, nor as a forgotten public
    repository.

Changed

  • dsoxlab new catalog links to the engine documentation instead of copying
    it
    (#201). The README it wrote carried a copy of the contract and of a
    lab's lifecycle, frozen on the day of new catalog; an inventory on
    2026-11-14 found 50 false files in 21 catalogues, most born from that
    skeleton. The section is now "The engine, documented where it lives", with
    links to contract-v1, commands, learner and catalog-author. The
    generated CI workflow no longer says validate-structure only sees what
    loaded, false since 0.1.97.
  • validate-structure reports engine documentation that a catalogue copied
    and that became false
    (new family stale_doc, #201). It looks for known
    false sentences in versioned Markdown outside labs/ and solution/,
    CHANGELOGs excluded: list-labs to run before validate-structure (false
    since 0.1.97), dsoxlab status as the host reachability test (it is
    dsoxlab infra status), runtime.host (never read), fixtures copied flat
    (false since 0.1.37). Measured on the catalogues on 2026-11-14: 38 files in
    18 catalogues, no false positive. validate-structure --json gains the
    stale_doc count, an additive key.

Documentation

  • Durable decisions now live in docs/decisions/, one record each (#203).
    Several modules carried architecture reasoning in their comments: why a
    flock and why its file is never deleted, why ansible-core is declared
    despite its 100 MB, why first-boot packages do not block. That reasoning was
    in the right words but in the wrong place: it made files long, and could not
    be found when asking "why this choice?". Fourteen records, each in English
    and French, with the same short shape: context, decision, consequences, what
    would reverse it, status and date. The eight decisions listed in the issue
    are joined by six taken since: the fixture reversal, the degraded state of
    a lab without its engine, the three outcomes of a check, the stable index of
    optional hosts, the refusal of out-of-contract hosts, and the catalogue table
    measured on the published repositories. The reasoning was moved, not
    summarized: every measurement keeps its date.
  • The code keeps one line and a pointer. locking.py, pyproject.toml,
    the two template READMEs, test_journal_en_anglais.py, infra/terraform.py,
    scripts/gen-catalogues.py and a few docstrings now say the essential in one
    line and point at their record. Comments that explain a single line stay
    where they are. No behaviour changes.
  • tests/test_decisions.py keeps the directory honest: each record has its
    sections and its twin in the other language, the index lists every record,
    and every docs/decisions/… pointer written in the repository leads to an
    existing file. It is shown to refuse a broken pointer.
  • docs/README.md and docs/design-principles.md (and their French versions)
    point at the new directory: the principles say what is true, the decisions
    say why it was chosen.