From 5dcfc0867bc170e9a38ce111d19cbe13ea71c55c Mon Sep 17 00:00:00 2001 From: Jakub Zych Date: Thu, 1 Oct 2026 15:09:12 +0200 Subject: [PATCH] docs(11.2): record site_label and pretty docs link decisions --- .../11.2-CONTEXT.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/.planning/phases/11.2-ready-to-share-summercms-io-website-and-newsletter-plugin/11.2-CONTEXT.md b/.planning/phases/11.2-ready-to-share-summercms-io-website-and-newsletter-plugin/11.2-CONTEXT.md index deafdd9..6f4c1c2 100644 --- a/.planning/phases/11.2-ready-to-share-summercms-io-website-and-newsletter-plugin/11.2-CONTEXT.md +++ b/.planning/phases/11.2-ready-to-share-summercms-io-website-and-newsletter-plugin/11.2-CONTEXT.md @@ -67,6 +67,10 @@ Out of scope: newsletter signup, the Polish locale and the subscriber admin. The - **D-37:** SEO uses the full `@nuxtjs/seo` module, as `vue-fonoteka-app` does: meta, Open Graph and Twitter tags, OG image, schema.org, sitemap and robots. Whatever it generates must work with `nuxt generate` and be embedded (no runtime OG rendering in the Go binary). - **D-45:** The prototype's `showRays` and `scrollSpy` flags become Nuxt app config, both defaulting to `true`. +### Planning-session decisions (2026-10-01, after research) +- **D-46:** D-41 is extended. `docs/site.yaml` gets an optional `site_url` and an optional `site_label`. `summer docs:build` and `summer docs:serve` accept `--site-url` and `--site-label` flags that override them, the same way `--base-url` overrides `base_url`. The framework's own `site.yaml` sets neither, so its docs output is unchanged. If `site_label` is unset, the label is the URL's host, or "Home" for a relative URL. The summercms.io build passes `--site-url /` and `--site-label summercms.io`, so the header reads "← summercms.io". +- **D-47:** The landing page keeps the handoff's extension-less `/docs/...` hrefs exactly as written (for example `/docs/backend/admin-spa`). `sm-summercms-plugin` answers an extension-less `/docs/x` with a 301 to `/docs/x.html` when that page exists. The SC3 link check follows the redirect and requires the final 200. + ### Get started accuracy - **D-38:** Both Source links point to `https://git.golem15.com/golem15/summercms`. The repo currently requires login, so making it public is a launch checklist item in DEPLOY.md, done manually by the user before cutover. The link check (roadmap criterion 3) verifies anonymous access at cutover time. - **D-39:** The terminal card gets a clone step so it works when pasted into a fresh shell: a `# get the framework` comment, then `$ git clone https://git.golem15.com/golem15/summercms` and `$ cd summercms`, before the existing `go install ./cmd/summer` group. The Copy button copies every command line in order (now six), without `$` or comments.