24782e89cb
Some checks failed
C++ Tests / test-fast (pull_request) Successful in 2m12s
API Docs / doc-build (pull_request) Successful in 45s
Markdown link check / check (pull_request) Successful in 47s
C++ Tests / test-cgal (pull_request) Failing after 8m22s
C++ Tests / quality-gates (pull_request) Failing after 1m55s
Two additions that close out the reviewer-prep work cleanly:
1. doc/reviewer/hub.html + publish-workflow integration
──────────────────────────────────────────────────────
Move the hand-curated reviewer hub from the codeberg `pages`
branch (where it lived as an opaque snapshot) into the repo as
`doc/reviewer/hub.html`. `.gitea/workflows/doxygen-pages.yml`
gains a conditional `if [ -f doc/reviewer/hub.html ]; then …`
step that installs it as the publish `index.html` and demotes
the auto-generated Doxygen index to `/doxygen.html`.
Effect: merging any of the open PRs into main will trigger the
workflow, which republishes BOTH the Doxygen + the reviewer hub
together. The reviewer URL stays live across merges with zero
manual intervention.
Source-controlled benefits:
* hub edits go through normal PRs, not orphan-branch
force-pushes
* old hub versions live in git history
* the in-repo links now target `branch/main/…` instead of the
transient `preview/reviewer-snapshot-vN/…` paths
2. .gitea/workflows/perf-compile-time.yml — Linux CI bench
────────────────────────────────────────────────────────
New workflow runs on every push to main that touches the build
system or public headers. Five-step matrix measures and reports:
Run 1 cold baseline (no PCH, no Unity, no ccache)
Run 2 + PCH only
Run 3 + PCH + Unity (current default)
Run 4 + FAST_TEST_BUILD=ON (-O0 -g — Linux's expected ~40 % win)
Run 5 + ccache warm rerun (expected ≥ 90 % cache hit)
Validates the Apple-M1 predictions in doc/architecture/compile-time.md
against the Linux + g++ runner where Backend dominates more and
the Apple-clang+PCH friction that defeats ccache locally does not
apply. Job is data-collection only; never blocks a merge.
doc updates:
* doc/architecture/compile-time.md — new "Cross-platform perf bench"
section linking to the workflow + the table of macOS-vs-Linux
expected deltas.
* doc/reviewer/README.md — new "Hub-Page durability" subsection
explaining how the hub survives merges.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
55 lines
2.9 KiB
Markdown
55 lines
2.9 KiB
Markdown
# Reviewer meeting materials
|
|
|
|
A single landing page for the three documents associated with an
|
|
external-reviewer meeting. The materials are written for a peer who
|
|
actively publishes in discrete differential geometry — specifically
|
|
the decorated-DCE / Penner-coordinates / hyperideal-polyhedra /
|
|
canonical-tessellations research line — and who would potentially
|
|
use conformallab++ as numerical infrastructure for their own future
|
|
experiments.
|
|
|
|
| Document | Audience | Purpose |
|
|
|---|---|---|
|
|
| [`briefing.md`](briefing.md) | **the reviewer** | one-page orientation: what the project is, where to look first, what we want from them |
|
|
| [`questions.md`](questions.md) | **the reviewer** | the 5 concrete decisions we want their opinion on (skim before the meeting) |
|
|
| [`agenda.md`](agenda.md) | **me** | my own meeting playbook: timing, order, the "no" question, post-meeting memo template |
|
|
|
|
After the meeting, a fourth file `2026-XX-XX-meeting-notes.md` should
|
|
land here too — the memo template at the bottom of `agenda.md` is the
|
|
suggested structure.
|
|
|
|
## When to send to the reviewer
|
|
|
|
- **briefing.md** + **questions.md**: as part of the meeting-confirmation
|
|
email, ~5 business days before the meeting. Subject line: *"Pre-read
|
|
for our conformallab++ chat (~15 min)"*.
|
|
- **agenda.md**: never send. This is internal scaffolding.
|
|
|
|
## Hub-Page durability
|
|
|
|
The reviewer hub HTML at <https://tmoussa.codeberg.page/ConformalLabpp/>
|
|
is published from `doc/reviewer/hub.html` in the repo (not from a
|
|
detached preview branch). This means:
|
|
|
|
* Merging any of the open PRs into `main` triggers
|
|
`.gitea/workflows/doxygen-pages.yml` which republishes the hub
|
|
alongside fresh Doxygen HTML — the reviewer URL stays live across
|
|
merges with no manual intervention.
|
|
* The hub is source-controlled, so changes are reviewable via PR
|
|
like any other doc, and old versions live in git history.
|
|
* The original Doxygen index moves to `/doxygen.html` whenever the
|
|
hub override is active; both are reachable from the hub itself.
|
|
|
|
## Quick links the reviewer should bookmark
|
|
|
|
- 🌐 Reviewer-hub landing page: <https://tmoussa.codeberg.page/ConformalLabpp/>
|
|
(the hub shows status badges, a "what's new" banner with the most
|
|
recent delta, the research-alignment table, and direct links into
|
|
every document below)
|
|
- 📦 Source: <https://codeberg.org/TMoussa/ConformalLabpp>
|
|
- 📝 Architecture decisions (incl. the Q7 "no" prompt): [`../architecture/locked-vs-flexible.md`](../architecture/locked-vs-flexible.md)
|
|
- 📐 Schläfli derivation (for Q3): [`../math/hyperideal-hessian-derivation.md`](../math/hyperideal-hessian-derivation.md)
|
|
- 📚 Literature index (for Q1 + Q3): [`../math/references.md`](../math/references.md)
|
|
- 🗺️ Per-phase roadmap (for Q1): [`../roadmap/phases.md`](../roadmap/phases.md)
|
|
- 🧪 Research-track entries with acceptance criteria (Q1 + Q2): [`../roadmap/research-track.md`](../roadmap/research-track.md)
|