SolDocs content

Markdown for docs.playsol.us (docs/) and wiki.playsol.us (wiki/).

Pushes to master / main zip and upload content to the PlaySol server (chunked, cloudflared-safe).

Layout

docs/
  navigation.json
  *.md
wiki/
  navigation.json
  *.md

Frontmatter on each page:

---
title: "Page title"
description: "Short summary"
order: 10
---

GitHub secrets

Configure these as secrets (not variables) on the repo:

Secret	Required	Notes
PLAYSOL_API_BASE	yes	Site origin, e.g. https://playsol.us
PLAYSOL_DEPLOY_SECRET	yes	Same deploy secret as the server
PLAYSOL_AUTH_PATH	yes	Token exchange path (keep secret; must match server DEPLOY_AUTH_PATH)
PLAYSOL_CONTENT_UPLOAD_PATH	no	Defaults to /api/v1/content/upload
PLAYSOL_CONTENT_INIT_PATH	no	Defaults to /api/v1/content/upload/init

Workflows

• deploy-content.yml — deploy on push to master/main
• warn-workflow-changes.yml — fails + comments when a PR touches .github/workflows/

Local upload

From the PlaySol server repo:

export PLAYSOL_API_BASE=https://playsol.us
export PLAYSOL_DEPLOY_SECRET=...
export PLAYSOL_AUTH_PATH=...
./scripts/deploy-content.sh /path/to/SolDocs-content