How This Dossier Is Updated
Nordvik Region follows the series. When a volume is published, revised or found to contradict another, the dossier is brought in step in the order below. The order is the same for the sibling dossier Hansa Mutual, and the two are updated in the same pull request set.
When a new volume appears (Book 15 and later)
- Extract. Read the volume's example-organisation profile and every chapter that names Nordvik Region. Write
data/extracts/NN_<slug>.mdwith the eight sections the other extracts have: role in the book, profile additions, people, systems and identifiers, events, figures, decisions, inconsistencies. - Ledger. Append the identifiers, events and figures to
data/ledger.jsonl. Runpython3 scripts/check_ledger.pywith the checkouts of the series next to this repository: it fails if a ledger line cites an identifier that is not in the cited chapter, and lists identifiers in the volume that name Nordvik Region and are not in the ledger. - Chapter. Add the volume's chapter to Part III in
scripts/toc_definition.py, run it with--write, and write the chapter. A new volume gets the next lettered chapter after the last volume chapter (Book 14 is Chapter 19A, after Chapter 19 on Book 13), so that no chapter number changes and the cross-references in the other chapters, in Hansa Mutual and in the series stay valid; the lettered chapters are renumbered only in a renumbering release, which also updates every reference. Write the chapter to the brief indocs/BOOK_BLUEPRINT.md(role in the book, additions, decisions and records, usage modes, open threads). - Cross-cutting chapters. Revise Chapters 2 to 7 where the profile, structure, legal setting, estate, suppliers or posture changed, and Chapters 21 to 24 (chronology, decisions, numbers, cast). Add findings to Chapter 27.
- Rules. Move
cites_up_toinbook.yaml, add the volume to the bibliography as the next numbered source, regenerate Appendix A (python3 scripts/build_appendix_a.py), runbookengine test -qandbookengine run audit_references. - Credibility. If the volume gives Nordvik Region a new scale, system class, supervisor or incident, re-run the comparison of Part V for that dimension.
- Companions. Update the other sites that carry this book (the series landing page, presentations, whitepapers, courses, shorts and posters; their registries take a new entry from
book.yaml).
When an earlier volume changes
Diff the volume's profile, rerun scripts/check_ledger.py, and correct the ledger lines and the chapters it flags. A correction in a volume that the dossier had recorded as an inconsistency is moved from Chapter 27 to a note in the chapter concerned.
Version and date
Each release states the series state it reflects (the last volume and its date) on the title page of Chapter 1. The date of the extract is in the header of every file in data/extracts/.