Skip to content

Publish the site as the Lightcone Research Stack docs - #2

Merged
EiffL merged 4 commits into
mainfrom
publish-github-pages
Sep 27, 2026
Merged

EiffL merged 4 commits into
mainfrom
publish-github-pages

Conversation

@EiffL

@EiffL EiffL commented Sep 27, 2026 •

Copy link
Copy Markdown
Member

Summary

Publishing

  • .github/workflows/docs.yml replaces build.yml. Every PR still gets a strict zensical build. On main (push or manual run), the same build is uploaded and deployed to GitHub Pages.
  • site_url = "https://docs.lightconeresearch.org/", so canonical links and the sitemap use the real domain.

Lightcone Research Stack branding

  • The site name and description are now "Lightcone Research Stack".
  • On the home page:
    • The intro and alpha warning now describe the whole stack, and the warning points to the LightconeResearch org for issues.
    • "Two libraries, one toolchain" is now "Components of the stack".
    • The contributor card says it covers lightcone-cli's internals.
  • Pages about the CLI itself are unchanged.

README and license

  • README.md is rewritten as a landing page for readers: what the stack is, a link to the site, where to start, the components, and where to report problems.
  • LICENSE is lightcone-cli's BSD 3-Clause (CNRS and The Regents of the University of California). The imported pages were already published under it.

Repo settings (already applied)

  • Pages is enabled with Source: GitHub Actions.
  • Custom domain is docs.lightconeresearch.org, with the HTTPS certificate approved and HTTPS enforced. The DNS record already pointed at GitHub Pages, but no repo claimed the domain, so it was returning a 404.

The first deploy runs when this PR is merged.

Test plan

  • uv run zensical build --clean --strict: no issues; canonical and sitemap URLs use https://docs.lightconeresearch.org/
  • actionlint passes on the workflow
  • Every docs link in the README resolves to a built page
  • After merge: the deploy job succeeds and https://docs.lightconeresearch.org serves the site

🤖 Generated with Claude Code

EiffL and others added 4 commits September 27, 2026 16:27
Replace the build-only workflow with one that builds in strict mode on
every PR and, on main, deploys the same build to GitHub Pages. Set
site_url so canonical links and the sitemap point at
docs.lightconeresearch.org.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
setup-uv publishes no floating major tag, so @v10 does not resolve.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Rename the site and rewrite the home page intro and alpha warning for the
stack rather than lightcone-cli alone. Pages about the CLI itself are
unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The README is now the repository's landing page for readers: what the
stack is, where the docs live, where to start, and where to report
problems. The license is lightcone-cli's, which the imported content was
already published under.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@EiffL
EiffL force-pushed the publish-github-pages branch from e29c5c6 to 49d5a35 Compare September 27, 2026 23:27
@EiffL EiffL changed the title Publish the site to GitHub Pages Publish the site as the Lightcone Research Stack docs Sep 27, 2026
@EiffL
EiffL merged commit f27c7f2 into main Sep 27, 2026
2 checks passed
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