Skip to content

Docs: restructure the site and add contributor pages - #49

Merged
SandObserver merged 1 commit into
mainfrom
docs/restructure-docs-site
Sep 13, 2026
Merged

SandObserver merged 1 commit into
mainfrom
docs/restructure-docs-site

Conversation

@SandObserver

Copy link
Copy Markdown
Owner

Summary

  • Reorganise the sidebar into Get started, Build your dashboard, Widgets, Run Stackyard, Settings, Troubleshooting, Create a widget, Contributing and About, with search-oriented page titles.
  • Rebuild every widget page on shared ServiceList, SettingList and LinkList components: a live preview, the supported services with their fields and project links, and the settings.
  • Add Create a widget (tutorial, manifest, data, widget page, checklist) with a live preview of the repository widget template, synced by sync-widgets.mjs.
  • Add Contributing pages (how to contribute, architecture, design system, translations, API errors, releasing) and generated Security policy and Governance pages.
  • Move environment variables onto the Docker page, add a reverse proxy page, fold the socket proxy setup into Badges, and add the SSRF range table to Security.
  • Fix the cosign identity pattern to the repository's case.
  • Redirect /docs/development/, /docs/adding-services/ and /docs/advanced-configuration/ with Astro redirects and public/_redirects.
  • Add a light-background version of the mark.

Testing
npm run build and npm run check pass. Verified in Chrome in dark, light and forced light themes at 1280px and 400px, with no horizontal overflow.

Checklist

  • npm run build and npm run check both pass.
  • Product UI is shown by running or capturing it, never recreated in CSS.
  • Any new preview or screenshot carries no private hostnames or real data.
  • Visual changes verified in both colour schemes and both docs themes.
  • Links to the app repo still resolve.

@SandObserver SandObserver added the documentation Improvements or additions to documentation label Sep 13, 2026
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying stackyard-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 4fb51d9
Status: ✅  Deploy successful!
Preview URL: https://15b17c28.stackyard-docs.pages.dev
Branch Preview URL: https://docs-restructure-docs-site.stackyard-docs.pages.dev

View logs

@SandObserver
SandObserver merged commit 74e12e8 into main Sep 13, 2026
2 checks passed
@SandObserver
SandObserver deleted the docs/restructure-docs-site branch September 13, 2026 17:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant