Skip to content

docs: ML07-0001 and ML07-0002 as First Edition (-1) - #490

Merged
mgrossmann merged 1 commit into
mainfrom
doc-1239-first-edition
Oct 31, 2026
Merged

mgrossmann merged 1 commit into
mainfrom
doc-1239-first-edition

Conversation

@mgrossmann

Copy link
Copy Markdown
Contributor

Closes #489.

Summary

  • Both books move from -0 (Draft) to -1: number, title page, edition notice, landing page of the Read the Docs site, PDF names in docs/books/Makefile and web/build.sh.
  • The capture notes in the edition notices and in the chapters on installing and upgrading name the build of the 4.5.1 source made before the release and say that a start of the published package was not captured. The behaviour described is unchanged.
  • docs/books is otherwise identical to the tag v4.5.1, so PDFs built from the merge commit describe 4.5.1 plus only the edition change.

Docs

Books only, no code. Edition state and capture notes: docs/books/ml07-0001.typ, ml07-0002.typ, guide/ug-install.typ, guide/ug-upgrade.typ.

Test plan

  • make -C docs/books with typst 0.15.1 builds ml07-0001-1.pdf and ml07-0002-1.pdf
  • sh docs/books/web/build.sh builds the site; ML07-000x-1 and "First Edition" on the title pages, no "Draft" left
  • cross-read by QA

The books describe HTTPD 4.5.1 as published. The title pages, the landing
page and the PDF names drop the Draft state, and the passages on how the
sessions were captured no longer speak of a release branch or a project file
change. They say that the captures come from a build of the 4.5.1 source made
before the release, and that a start of the published package was not
captured. Refs #489.
@mgrossmann mgrossmann added this to the 4.6.0 milestone Oct 31, 2026
@sonarqubecloud

Copy link
Copy Markdown

@read-the-docs-community

Copy link
Copy Markdown

Documentation build overview

📚 httpd | 🛠️ Build #35546795 | 📁 Comparing f58f92b against latest (1db2a66)

  🔍 Preview build  

5 files changed · ± 5 modified

± Modified

@mgrossmann mgrossmann left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cross-read: ACCEPTED. docs/ differs from tag v4.5.1 in exactly the seven files of this PR, so PDFs built from the merge commit describe 4.5.1 plus the edition change only. Built both books with typst 0.15.1 (ml07-0001-1.pdf, ml07-0002-1.pdf) and the site with web/build.sh: ML07-000x-1 and "First Edition (October 2026)" everywhere, no Draft notice left. The Read the Docs preview shows the same. Note: Read the Docs stable follows the v4.5.1 tag and keeps the Draft books until a newer tag; the release-4.5.x branch needs the same change.

@mgrossmann
mgrossmann merged commit 2190f92 into main Oct 31, 2026
5 checks passed
@mgrossmann
mgrossmann deleted the doc-1239-first-edition branch October 31, 2026 15:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: ML07-0001 and ML07-0002 as First Edition (-1), not Draft

1 participant