Skip to content

docs: Record the final JOSS manuscript proof. - #6537

Closed
franciscojavierarceo wants to merge 1 commit into
mainfrom
codex/joss-proof-final
Closed

franciscojavierarceo wants to merge 1 commit into
mainfrom
codex/joss-proof-final

Conversation

@franciscojavierarceo

Copy link
Copy Markdown
Collaborator

the paper README still points to the proof generated before #6532 merged. this records the new proof, its SHA-256, and the corresponding manuscript snapshot after #6532.

both manuscript files at the existing pin are byte-identical to merge commit 016a6079594de71b58cba2e58842126fadda2ec1. all six rendered pages were inspected: the AI disclosure is on page 4, immutable OGX/operator references are on page 5, and the corrected SGLang author list and DOI are on page 6. changed-file pre-commit and git diff --check pass. this updates proof provenance only; the manuscript and bibliography are unchanged.

Signed-off-by: Francisco Javier Arceo <farceo@redhat.com>
@franciscojavierarceo

Copy link
Copy Markdown
Collaborator Author

superseded by #6548, which includes this proof link, hash, source snapshot, and page references alongside the new manuscript corrections. the README now makes clear that the 10 September proof predates those edits and needs regeneration after merge. closing this duplicate so the source pins and proof record can be reviewed together.

mattf pushed a commit to mattf/llama-stack that referenced this pull request Sep 15, 2026
the JOSS manuscript still describes Safety as an interchangeable
provider layer, although Responses guardrails call an external
moderation endpoint. this corrects the Summary and architecture claims
and the matching stale API/configuration documentation, following the
[14 September
findings](openjournals/joss-reviews#11234 (comment)).

the paper now explicitly describes the cited v1.0.3 release: 23
inference provider types and 13 vector provider types across 10
backends. the README links the exact registries and explains why
reviewed main has 25 inference types and 14 vector types across 11
backends. Interactions is identified as alpha; Containers and Skills are
omitted because they are absent from v1.0.3.

the reference audit records checks of all 19 DOI-less entries. no
additional DOI was verified for the exact cited works. the bibliography
corrects the Oracle post's authors/year and the MLflow article's
metadata and source URL.

this also incorporates the proof record from ogx-ai#6537 and pins the revised
manuscript pair. the recorded 10 September proof predates these edits;
we should regenerate it after merge.

validation: provider registries, API availability, and moderation
configuration checked against both source snapshots; all 22 citation
keys resolve to bibliography entries; changed-file pre-commit and `git
diff --check` pass. under Node 22, `npm ci --no-audit --no-fund`, `npm
run gen-api-docs all`, and `npm run build` pass in `docs`, including
strict broken-link and anchor checks. an independent source review found
no remaining introduced inaccuracies. runtime functionality was not
retested for this paper/documentation change.

---------

Signed-off-by: Francisco Javier Arceo <farceo@redhat.com>
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.

1 participant