Bill Traynor (wmat) · Sep 9, 2026 · Sep 9, 2026
diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc
@@ -14,3 +14,9 @@
 * xref:linting.adoc[Linting]
 * xref:build-infrastructure.adoc[Build Infrastructure]
 * xref:bibliography.adoc[Bibliography]
+// Back matter. Appended rather than placed up front (where the template puts
+// them) so the chapter line numbers above do not shift: the central playbook's
+// numbering_rules entry for this component keys chapters off LINE NUMBERS in
+// this file. See MIGRATION.md Step 11.
+* xref:contributors.adoc[Contributors]
+* xref:copyright.adoc[Copyright and license information]
diff --git a/modules/ROOT/pages/author-quickstart.adoc b/modules/ROOT/pages/author-quickstart.adoc
@@ -105,8 +105,8 @@ src/spec-sample.adoc                    <9>
 <1> Images used in the spec. These are referenced from the chapter files and included in both PDF and HTML output.
 <2> Site landing / cover page. HTML-only -- **not** part of the PDF. Follow the instructions in this file to update the content.
 <3> The introduction chapter. Becomes "Chapter 1" in the PDF.
-<4> Front matter that lists contributors. HTML only -- **not** part of the PDF. Follow the instructions in this file to update the content.
-<5> Copyright and license information. HTML only -- **not** part of the PDF. Follow the instructions in this file to update the content.
+<4> Front matter that lists contributors. Included in both PDF and HTML: the site navigation renders it as a page, and the PDF assembler includes it as a `[preface]` ahead of the first chapter. Follow the instructions in this file to update the content.
+<5> Copyright and license information. Included in both PDF and HTML, the same way as the contributors file. Follow the instructions in this file to update the content.
 <6> Bibliography main page. Included in both PDF and HTML and uses the bibliography database (`riscv-spec.bib`) to render the references.
 <7> Bibliography database.
 <8> HTML navigation file -- Update references to your chapter files here. This is the site navigation that builds the HTML output.

diff --git a/modules/ROOT/pages/contributors.adoc b/modules/ROOT/pages/contributors.adoc
@@ -0,0 +1,16 @@
+== Contributors
+
+This guide has been contributed to directly or indirectly by:
+
+[%hardbreaks]
+* Kevin Broch
+* Stephano Cetola
+* Paul A. Clarke
+* Brian Grayson
+* Jeff Osier-Mixon
+* Kersten Richter
+* Elisa Sawyer
+* Jeff Scheel
+* Josh Scheid
+* Rafael Sene
+* Bill Traynor
diff --git a/modules/ROOT/pages/copyright.adoc b/modules/ROOT/pages/copyright.adoc
@@ -0,0 +1,9 @@
+[preface]
+== Copyright and license information
+
+This documentation is licensed under the Creative Commons
+Attribution 4.0 International License (CC-BY 4.0). The full
+license text is available at
+https://creativecommons.org/licenses/by/4.0/.
+
+Copyright 2026 by RISC-V International.
diff --git a/src/docs-dev-guide.adoc b/src/docs-dev-guide.adoc
@@ -9,11 +9,13 @@ ifndef::revnumber[:revnumber: v0.0]
 ifndef::revdate[:revdate: 1970-01-01]
 ifndef::spec_short[:spec_short: docs-dev-guide]
 :revinfo:
+// Shared RISC-V attributes (:company:, :url-riscv:, :doctype: book) from the
+// docs-resources submodule, so this document picks up changes to them centrally.
+// PDF-ONLY: this cross-repo relative include cannot resolve under Antora, which
+// is why it lives in the assembler and never in a page. See MIGRATION.md Step 7.
+include::../docs-resources/global-config.adoc[]
 //:title-logo-image: image:risc-v_logo.png[pdfwidth=3.25in,align=center]
 :description: A working template for documenting RISC-V architecture in asciidoc
-:company: RISC-V.org
-:url-riscv: http://riscv.org
-:doctype: book
 //:preface-title: Preamble
 //:colophon:
 //:appendix-caption: Appendix
@@ -34,7 +36,10 @@ ifndef::spec_short[:spec_short: docs-dev-guide]
 :lang: en
 :listing-caption: Listing
 :sectnums:
-:toc: left
+// `macro` rather than `left` so the toc::[] call below controls placement -- the
+// TOC follows the front matter, as in the template's assembler.
+:toc: macro
+:toc-title: Table of Contents
 :toclevels: 4
 :source-highlighter: pygments
 ifdef::backend-pdf[]
@@ -57,6 +62,27 @@ endif::[]
 
 //This document is released under a Creative Commons Attribution 4.0 International License.
 
+// This repo runs in doc mode, so there is no "Document State" preface to render
+// ahead of the TOC -- see MIGRATION.md "Doc mode".
+toc::[]
+
+[preface]
+== List of figures
+list-of::image[hide_empty_section=true, enhanced_rendering=true]
+
+[preface]
+== List of tables
+list-of::table[hide_empty_section=true, enhanced_rendering=true]
+
+[preface]
+== List of listings
+list-of::listing[hide_empty_section=true, enhanced_rendering=true]
+
+include::../modules/ROOT/pages/copyright.adoc[]
+
+[preface]
+include::../modules/ROOT/pages/contributors.adoc[]
+
 include::../modules/ROOT/pages/intro.adoc[]
 
 include::../modules/ROOT/pages/author-quickstart.adoc[]
@@ -83,4 +109,10 @@ include::../modules/ROOT/pages/linting.adoc[]
 
 include::../modules/ROOT/pages/build-infrastructure.adoc[]
 
+// The index must precede the bibliography. The index macro is PDF-only (Antora
+// does not generate a back-of-book index), so it lives here in the assembler
+// rather than in a page.
+[index]
+== Index
+
 include::../modules/ROOT/pages/bibliography.adoc[]