Skip to content

ci(docs): notify thast-docs and modernise architecture diagram#1

Open
FiLORUX wants to merge 2 commits into
mainfrom
ci/notify-docs
Open

ci(docs): notify thast-docs and modernise architecture diagram#1
FiLORUX wants to merge 2 commits into
mainfrom
ci/notify-docs

Conversation

@FiLORUX
Copy link
Copy Markdown
Owner

@FiLORUX FiLORUX commented May 4, 2026

Summary

  • ci: notify thast-docs on doc-relevant pushes — adds .github/workflows/notify-docs.yml. On any push to main that touches README.md or LICENSE, posts a docs-update repository_dispatch to FiLORUX/thast-docs, which then rebuilds and redeploys https://docs.xn--thst-roa.se/sptime/.
  • docs: rewrite architecture diagram as mermaid flowchart — replaces the ASCII art block with a ```mermaid flowchart. Renders natively on github.com and as inline SVG with the brand palette on the docs site.

Required secret

Before this workflow becomes useful, add a repo secret on FiLORUX/sptime:

  • Name: DOCS_DISPATCH_TOKEN
  • Type: fine-grained PAT
  • Scope: Contents: write on FiLORUX/thast-docs
  • Expiry: your call — without it the curl call returns 401 and the deploy is silently skipped.

Companion PR

FiLORUX/thast-docs#4 adds the matching sync-docs entry, sidebar group and CI checkout step.

Test plan

  • Verify the mermaid block renders correctly on github.com (README preview)
  • After both PRs merge and DOCS_DISPATCH_TOKEN is set, push a no-op commit touching README.md and confirm thast-docs rebuilds
  • Visit https://docs.xn--thst-roa.se/sptime/ and verify the page loads with the architecture diagram rendered

FiLORUX added 2 commits May 4, 2026 17:35
Dispatches a docs-update repository event to FiLORUX/thast-docs whenever
README.md or LICENSE changes on main, so the docs hub rebuilds without
manual intervention. Requires DOCS_DISPATCH_TOKEN repo secret.
Same source renders natively on github.com (mermaid since 2022) and as
inline SVG with the Thåst brand palette on docs.xn--thst-roa.se via
rehype-mermaid.
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