Skip to content

Serve the docs as Markdown, name the site Sitex, and move the component docs to Fulldev UI - #34

Merged
silveltman merged 2 commits into
mainfrom
docs/markdown-and-name
Oct 19, 2026
Merged

silveltman merged 2 commits into
mainfrom
docs/markdown-and-name

Conversation

@silveltman

@silveltman silveltman commented Oct 19, 2026 •

Copy link
Copy Markdown
Contributor

Follows up on last night's Fulldev Scan of sitex.full.dev, and moves the component documentation to Fulldev UI: Sitex is the framework, and Fulldev UI holds the React components.

Changes

  1. Markdown versions. Every page has a Markdown version at its path with .md, the homepage at /index.md, as on full.dev and ui.full.dev. The build plugin in apps/docs/vite.config.ts (markdown(), which also writes llms.txt) serves each MDX file as written; the homepage's hero and features, which its layout renders from the frontmatter, follow as Markdown. Each page links its version with <link rel="alternate" type="text/markdown">, and llms.txt links to the .md files. Netlify serves .md as text/markdown; netlify.toml adds X-Robots-Tag: noindex for them, like ui.full.dev. The scan probes the alternate link, /path.md and /index.md, so it finds them. No Accept: text/markdown negotiation: full.dev and ui.full.dev do not have it either, and on Netlify it would need an edge function.
  2. Site name. The site's name is Sitex: og:site_name, the WebSite structured data (from the globals, not the page title) and llms.txt's heading. The scan's "Business name written in several ways" compares og:site_name with the names of organizations that are top-level or the WebSite's publisher, about, mainEntity, copyrightHolder or owner. Fulldev is now the WebSite's creator: it made Sitex, and the site's own name stays Sitex. Page titles are unchanged.
  3. Load time. netlify.toml lets browsers keep the hashed files in /assets/ for a year (immutable), as full.dev and ui.full.dev do for /_astro/. They were max-age=0, must-revalidate, so every page view checked the stylesheet again before rendering.
  4. Component docs moved to Fulldev UI. /docs/components and its 13 component pages are gone, with their navigation, Markdown versions, llms.txt and sitemap entries. Their framework part (static rendering, client directives, prefetch) is now /docs/rendering, where the older rendering addresses point again. The layouts page and the package README point to Fulldev UI's React components for ready-made components. Redirects (301):
    • /docs/components and /docs/ui/components to https://ui.full.dev/react/components/
    • /docs/components/{banner,header,layout,marquee,price,rating,section,theme-toggle,toc,typography} to the same name under https://ui.full.dev/react/components/
    • /docs/components/* (code, gradient, tile) and /docs/ui to https://ui.full.dev/react/
    • /docs/ui/installation to https://ui.full.dev/react/docs/installation/
    • /docs/ui/* still to /docs/components/:splat, which then redirects as above

Not changed

  • Component code and registry. apps/docs/src/components/ui stays. The docs site renders with code, header, layout, section, theme-toggle, toc and typography, and apps/docs/registry.json still publishes all 13 at https://sitex.full.dev/r/*.json; banner, gradient, marquee, price, rating and tile are only in that registry. The framework package uses none of them. Retiring the Sitex registry is a separate decision.
  • Unused JavaScript. Analytics already loads after the load event and idle time (Fix the docs site's Fulldev Scan findings #31); Lighthouse counts it because it downloads within its measuring window. The rest is React in islandClient, which the theme toggle on every page needs.
  • Render-blocking CSS. One 14.5 KB (gzip) stylesheet. Removing the delay means inlining CSS, a framework change in packages/sitex. full.dev has the same hint.

Verification

  • vp run fix, vp run check, vp run build and changeset status --since=origin/main pass.
  • dist has 6 pages, each with its .md; llms.txt and the sitemap list those 6.
  • Deploy Preview: every redirect above ends in a 200; /docs/rendering, the old rendering addresses and /r/*.json answer; .md files are text/markdown, which the Scan's Markdown test counts as usable; /assets/* has max-age=31536000, immutable. Previews mark every response noindex, so the .md noindex rule shows only in production.
  • Playwright on the Deploy Preview in Chromium, Firefox and WebKit at 1280 and 390 px: the 6 pages load without errors, every link and Markdown version answers 200, nothing links to /docs/components, and the sidebar and mobile navigation list Introduction, Installation, Pages, Layouts and Rendering.

🤖 Generated with Claude Code

- Every page has a Markdown version at its path with .md (the homepage at
  /index.md), linked from the page head and from llms.txt, as on full.dev
  and ui.full.dev. Search engines skip the .md files.
- The site's name is Sitex in og:site_name, the WebSite structured data
  and the social image's alt text. Fulldev is the site's creator.
- Browsers keep the hashed build files in /assets instead of checking
  them again on every page.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@netlify

netlify Bot commented Oct 19, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for fulldev-sitex ready!

Name Link
🔨 Latest commit b8ee7f8
🔍 Latest deploy log https://app.netlify.com/projects/fulldev-sitex/deploys/6ad5d74fdc5ef24e6cc8624f
😎 Deploy Preview https://deploy-preview-34--fulldev-sitex.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

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

Sitex is the framework; Fulldev UI holds the React components. The
component pages, their navigation, Markdown versions, llms.txt and sitemap
entries are gone, and their addresses redirect to the matching Fulldev UI
React page, or to its React docs when there is none.

The framework part of /docs/components, static rendering, client
directives and prefetch, is now /docs/rendering, where the older
rendering addresses point again. The layouts page and the package README
point to Fulldev UI for ready-made components.

The component code in apps/docs/src/components/ui stays: the docs site
renders with it and the registry at /r/ still publishes it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@silveltman silveltman changed the title Serve the docs as Markdown and name the site Sitex Serve the docs as Markdown, name the site Sitex, and move the component docs to Fulldev UI Oct 19, 2026
@silveltman
silveltman marked this pull request as ready for review October 19, 2026 08:47
@silveltman
silveltman merged commit 3c7f6da into main Oct 19, 2026
11 checks passed
@silveltman
silveltman deleted the docs/markdown-and-name branch October 19, 2026 09:43
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