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)

  1. Extract. Read the volume's example-organisation profile and every chapter that names Nordvik Region. Write data/extracts/NN_<slug>.md with the eight sections the other extracts have: role in the book, profile additions, people, systems and identifiers, events, figures, decisions, inconsistencies.
  2. Ledger. Append the identifiers, events and figures to data/ledger.jsonl. Run python3 scripts/check_ledger.py with 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.
  3. 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 in docs/BOOK_BLUEPRINT.md (role in the book, additions, decisions and records, usage modes, open threads).
  4. 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.
  5. Rules. Move cites_up_to in book.yaml, add the volume to the bibliography as the next numbered source, regenerate Appendix A (python3 scripts/build_appendix_a.py), run bookengine test -q and bookengine run audit_references.
  6. 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.
  7. 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/.