kindred/create
1
1
Fork 0
Code Issues 53 Pull Requests Actions Packages Projects 9 Releases 2 Wiki Activity

docs: add Silo server documentation with auto-sync workflow (#122) #123

Merged
forbes merged 1 commits from docs/sync-silo-server-docs into main 2026-02-09 18:39:03 +00:00
Conversation 0 Commits 1 Files Changed 17 +5006
forbes commented 2026-02-09 18:38:03 +00:00
Owner
Copy Link

Summary

Adds Silo server documentation to the mdBook site and sets up automated syncing from the kindred/silo repository.

Changes

New files

  • .gitea/workflows/sync-silo-docs.yml — workflow that syncs Silo server docs into this repo (daily schedule + workflow_dispatch for webhook triggering)
  • docs/src/silo-server/ — 14 markdown files copied from kindred/silo (specification, configuration, deployment, auth, status, etc.)

Modified files

  • docs/src/SUMMARY.md — added Silo Server section with links to all synced docs
  • .gitea/workflows/docs.yml — added step to fetch fresh silo docs before mdbook build, ensuring the deployed site always has the latest

How it works

  1. Committed docs: Silo server docs are committed to the repo at docs/src/silo-server/ for quick local reference
  2. Sync workflow: sync-silo-docs.yml runs daily (06:00 UTC) or on workflow_dispatch, sparse-clones the silo repo, copies docs, and commits any changes
  3. Build-time fetch: docs.yml also fetches fresh silo docs before each mdbook build, so the deployed site is always current

Related Issues

Closes #122

## Summary Adds Silo server documentation to the mdBook site and sets up automated syncing from the `kindred/silo` repository. ## Changes ### New files - `.gitea/workflows/sync-silo-docs.yml` — workflow that syncs Silo server docs into this repo (daily schedule + `workflow_dispatch` for webhook triggering) - `docs/src/silo-server/` — 14 markdown files copied from `kindred/silo` (specification, configuration, deployment, auth, status, etc.) ### Modified files - `docs/src/SUMMARY.md` — added Silo Server section with links to all synced docs - `.gitea/workflows/docs.yml` — added step to fetch fresh silo docs before mdbook build, ensuring the deployed site always has the latest ## How it works 1. **Committed docs**: Silo server docs are committed to the repo at `docs/src/silo-server/` for quick local reference 2. **Sync workflow**: `sync-silo-docs.yml` runs daily (06:00 UTC) or on `workflow_dispatch`, sparse-clones the silo repo, copies docs, and commits any changes 3. **Build-time fetch**: `docs.yml` also fetches fresh silo docs before each mdbook build, so the deployed site is always current ## Related Issues Closes #122
forbes added 1 commit 2026-02-09 18:38:04 +00:00
docs: add Silo server documentation with auto-sync workflow (#122)
Some checks failed
Build and Test / build (pull_request) Has been cancelled
Details
c3a1927bd3 
- Add sync-silo-docs.yml workflow (daily schedule + webhook dispatch)
- Copy initial Silo server docs into docs/src/silo-server/
- Update SUMMARY.md with Silo Server section
- Update docs.yml to fetch fresh silo docs before mdbook build
forbes merged commit 11eea63f70 into main 2026-02-09 18:39:03 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
Clear labels
UX
branding
bug
ci/cd
CI/CD workflows and deployment
 defaults
documentation
Developer documentation
 enhancement
high-priority
low-priority
theme
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
forbes
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: kindred/create#123
Delete Branch "docs/sync-silo-server-docs"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?