content/issue 31 Docs pages

[thescientist13]

Related Issue

resolves #31

Summary of Changes

1. Created Docs pages, lifted / shifted docs from the old site (created a shared CSS file between this and the Guides pages)
2. Integrated Edit on GitHub button
3. Documents Rendering Strategies (prerender vs SSR vs CSR) greenwood#951
4. Introduced a new Reference section to the docs

TODO

1. Welcome content
2. set color of popover x icons coloring on mobile (otherwise default color is blue)
3. final content review / drafting / links check
   • Check headings and casings (TypeScript, Plugin APIs)
   • Call out our influences
   • typeof catch for SSR + WCs escape hatch
   • GWD build environment variable
   • Npm callout for peer deps
   • Front matter as an array example - there's an example already in the imports section
4. track all Location redirects / audit of all old routes and deprecations - Website redesign, branding, and long term structure greenwood#978
   • /about/* -> /docs/introduction/about/
   • /plugins/ -> /docs/references/plugins-api/
   • /plugins/adapter/ -> /docs/reference/plugins-api/#adapter
   • /plugins/context/ -> /docs/reference/plugins-api/#context
   • /plugins/copy/ -> /docs/reference/plugins-api/#copy
   • /plugins/renderer/ -> /docs/reference/plugins-api/#renderer
   • /plugins/resource/ -> /docs/reference/plugins-api/#resource
   • /plugins/rollup/ -> /docs/reference/plugins-api/#rollup
   • /plugins/server/ -> /docs/reference/plugins-api/#server
   • /plugins/source/ -> /docs/reference/plugins-api/#source
   • /plugins/custom-plugins/ -> /docs/plugins/
   • /docs/component-model/ -> /docs/introduction/web-standards/#web-components
   • /docs/configuration/ -> /docs/reference/configuration/
   • /docs/front-matter/ -> /docs/resources/markdown/
   • /docs/markdown/ -> /docs/resources/markdown/#frontmatter
   • /docs/scripts/ -> /docs/resources/scripts/
   • /docs/css-and-images/ -> /docs/resources/styles/
   • /docs/layouts/ -> /docs/pages/layouts/
   • /docs/server-rendering/ -> /docs/pages/server-rendering/
   • /docs/api-routes/ -> /docs/pages/api-routes/
   • /docs/menus/ -> /docs/content-as-data/collections/
   • /docs/data/ -> /docs/content-as-data/
5. fix the active frontmatter example for <title>My Blog - ${globalThis.page.title}</title> showing up as null on /docs/content-as-data/active-frontmatter/ page
   • better solution deferred to cleaner solution for handling active frontmatter title examples on docs and guide pages displaying as null #125
   • custom plugin depends on chore/upgrade greenwood v0.30.0 alpha.7 #107
   
6. final feedback - content/issue 31 Docs pages #117 (review)

Questions

1. where should plugin (README) docs go (not launch blocking)? - Plugin Docs (READMEs) and website co-location #114 (comment)
2. Smaller font size on mobile (match blog post) - from the call, we agreed bigger font in the docs was preferable
3. Bun / deno callouts on hosting section? - not right now, will save for Agnostic Runtime greenwood#953

[netlify]

✅ Deploy Preview for super-tapioca-5987ce ready!

Name	Link
🔨 Latest commit	dc91f20
🔍 Latest deploy log	https://app.netlify.com/sites/super-tapioca-5987ce/deploys/6723b4c42d99be000884cb4e
😎 Deploy Preview	https://deploy-preview-117--super-tapioca-5987ce.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[thescientist13]

Some good final feedback from the meeting today, was knock down the drop shadow on the side nav active heading and ToC box (to --shadow-2)