AA b13 — Series-Wide Formatting Walkthrough (HEAVEN Papers)#

AIMS:

k4 s2 (Todo, MidTerm)

Status:

pending

Created:

2026m04d10

Two formatting issues affect all HEAVEN papers (b11–b17, ~35 files). Both are best fixed in a single walkthrough for consistency.

Task 1: Equation Line-Breaking#

Problem: Many .. math:: blocks contain LaTeX expressions that exceed the visible page width, causing horizontal scroll in HTML and overflow/clipping in PDF.

Solution: Apply the conventions from AHA/equation-layout.md:

  • Use \\ to force line breaks in equations

  • Use & for alignment points

  • Use \quad for continuation-line indentation

  • Aim for each line to be under ~60 characters of LaTeX source

  • Break after quantifiers, after \wedge, after \rightarrow, at condition list boundaries

Scope estimate: ~17 math blocks in b14-math alone; similar counts in b12-math, b13, b16, b17. Total estimate: 50–80 math blocks to check across the series.

Priority note: Does not affect correctness. Affects readability in PDF and narrow browser windows. Best done before any move toward OO (official output) stage.

Task 2: Draft-Note Relocation#

Problem: Every paper starts with a .. note:: **Draft status: block containing metadata (VVN, epistemic status, model attribution, dependencies). This is useful for authors and reviewers but creates visual clutter for readers — the first thing seen is administrative metadata rather than the paper’s title and content.

Decision needed from LLoL: Where should draft metadata live?

Options:

  1. Move to end of paper (before References) — keeps it in the rendered page but out of the visual introduction.

  2. Move to Appendix — pairs naturally with the Authorship appendix.

  3. Convert to a collapsed admonition (.. container:: toggle) — keeps it at the top but hidden by default.

  4. Move to RST comment (.. NOTE: ...) — invisible in rendered output, visible only in source. Loses rendered accessibility.

Scope estimate: 35 files use this pattern.

Priority note: Cosmetic. The decision should be made once and applied to all papers simultaneously. Not blocking any current work.

Sequencing#

Both tasks can be done in a single walkthrough session. Recommended timing: after the current b14 review cycle completes and before any papers move to OO stage.

Task 1 (equations) can be done independently. Task 2 (draft note) requires a design decision from LLoL first.