hostwarden/hostwarden.github.io
Watch
1
0
Fork
You've already forked hostwarden.github.io
 0
mirror of https://github.com/hostwarden/hostwarden.github.io.git synced 2026-11-07 13:12:36 +00:00
Code Issues Projects Releases Packages Wiki Activity
The Hostwarden documentation site
7 commits 1 branch 0 tags 160 KiB
  • HTML 72.4%
  • CSS 27.6%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
github-actions[bot] f02fde67b9 chore(docs): freeze a Docusaurus version
2026-09-26 14:01:10 +00:00
.github fix: assemble step still copied the renamed legal pages' old names 2026-09-25 12:41:14 +02:00
docs-site chore(docs): freeze a Docusaurus version 2026-09-26 14:01:10 +00:00
.gitignore feat: scaffold the one-pager and the docs publish workflow 2026-09-25 12:23:00 +02:00
AGENTS.md feat: replace the placeholder legal pages with real text 2026-09-25 12:38:56 +02:00
index.html feat: replace the placeholder legal pages with real text 2026-09-25 12:38:56 +02:00
legal-notice.html feat: replace the placeholder legal pages with real text 2026-09-25 12:38:56 +02:00
LICENSE feat: scaffold the one-pager and the docs publish workflow 2026-09-25 12:23:00 +02:00
privacy-policy.html docs: clarify that a rights request against us returns nothing 2026-09-25 13:24:36 +02:00
README.md feat: replace the placeholder legal pages with real text 2026-09-25 12:38:56 +02:00
style.css feat: replace the placeholder legal pages with real text 2026-09-25 12:38:56 +02:00

README.md

hostwarden.github.io

The one-pager at hostwarden.github.io and the workflow that publishes hostwarden.github.io/docs, the Docusaurus documentation site whose source lives in hostwarden/hostwarden's website/ directory. Why the site is split this way is recorded in that repository's docs/adr/20260925-docs-stay-in-repo-thin-publish.md.

What's here

  • index.html, legal-notice.html, privacy-policy.html, style.css — the one-pager. Hand-edited, reviewed like any other page.
  • .github/workflows/publish.yml — the only thing that ever writes to docs-site/, img/, fonts/ or _site/. It runs on a repository_dispatch from hostwarden/hostwarden (docs-updated on every push to website/**, release-cut when a release tags), or by hand (workflow_dispatch).
  • docs-site/ — an ephemeral Docusaurus checkout the workflow rebuilds from hostwarden/hostwarden's website/ on every run. Only versioned_docs/, versioned_sidebars/ and versions.json are committed here; everything else is regenerated and gitignored.

Nothing under docs-site/, img/, fonts/ or _site/ is hand-edited. A pull request touching those paths outside what the workflow itself commits is a mistake, not a contribution.

Setup

  • GitHub Pages → Build and deployment → Source: GitHub Actions (done).
  • A repository secret DOCS_DISPATCH_TOKEN in hostwarden/hostwarden (not here) — a fine-grained PAT scoped to this repository, Contents: write (done).