Skip to content

feat: add Scient Docs publishing pilot - #30

Closed
yaacovcorcos wants to merge 3 commits into
mainfrom
codex/scient-docs-publishing-pilot-20260828
Closed

yaacovcorcos wants to merge 3 commits into
mainfrom
codex/scient-docs-publishing-pilot-20260828

Conversation

@yaacovcorcos

@yaacovcorcos yaacovcorcos commented Aug 28, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • generate a 12-page /docs pilot from canonical scient-desktop/docs/user/ Markdown at one exact commit
  • publish source-aware HTML, raw Markdown, and a machine-readable search index without maintaining a second prose copy
  • add desktop and compact mobile navigation, topic and full-text search, preview applicability, source provenance, and truthful no-index preview labeling
  • define fail-closed source pinning, hashes, stable qualification, corrections, publication lag, and rollback

Preview

Source and dependencies

Verification

  • bun run check: 12 test files and 92 tests passed; Astro and Worker type checks, static build, and edge build passed
  • focused manifest tests cover immutable revisions, stable qualification, traversal rejection, hash drift, unsafe Markdown, link rewriting, deterministic generation, and UTF-8 response headers
  • built-artifact audit verified 12 rendered pages, exact raw hashes, source provenance, one main landmark per page, and local Docs links
  • deployed-preview audit verified HTML/raw/index response types, exact LaTeX raw hash, no-index behavior, desktop search, 390px navigation/content, source and raw links, and zero console errors
  • GitHub Website quality runs only for pull requests targeting main, so it is absent on stacked docs: promote website Docs ownership #29 and feat: add Scient Docs publishing pilot #30; the exact full command passed locally and will run when the stack is retargeted or integrated

Documentation impact

Updated — README.md, docs/architecture/scient-docs-publishing.md, and docs/scient-docs-manifest.json; dependent canonical Help source is ScientFactory/scient-desktop#196.

@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying scientfactory-website with  Cloudflare Pages  Cloudflare Pages

Latest commit: cbed6b7
Status: ✅  Deploy successful!
Preview URL: https://7b59cc0f.scientfactory-website.pages.dev
Branch Preview URL: https://codex-scient-docs-publishing.scientfactory-website.pages.dev

View logs

@yaacovcorcos
yaacovcorcos force-pushed the codex/documentation-governance-20260828 branch from ee32cc1 to a0cc7fb Compare August 29, 2026 08:17
Base automatically changed from codex/documentation-governance-20260828 to main August 29, 2026 08:20
@yaacovcorcos

Copy link
Copy Markdown
Contributor Author

Superseded by merged #31, which contains the complete 31-page exact-source Docs implementation, final navigation and interaction design, source/version evidence, and full validation. This pilot PR remains available as implementation history.

@yaacovcorcos
yaacovcorcos deleted the codex/scient-docs-publishing-pilot-20260828 branch August 29, 2026 08:47
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