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

.changeset/docs-markdown-and-name.md

@@ -0,0 +1,4 @@
+---
+---
+
+Serve the documentation website's pages as Markdown, name the site Sitex throughout, let browsers keep its build files, and move the component documentation to Fulldev UI's React components.

apps/docs/src/globals/index.yaml

@@ -1,4 +1,4 @@
-name: Sitex Docs
+name: Sitex
 logo:
   label: Sitex
   href: /
@@ -22,33 +22,5 @@ sidebar:
               label: Pages
             - href: /docs/layouts
               label: Layouts
-            - href: /docs/components
-              label: Components
-        - label: Components
-          links:
-            - href: /docs/components/banner
-              label: Banner
-            - href: /docs/components/code
-              label: Code
-            - href: /docs/components/gradient
-              label: Gradient
-            - href: /docs/components/header
-              label: Header
-            - href: /docs/components/layout
-              label: Layout
-            - href: /docs/components/marquee
-              label: Marquee
-            - href: /docs/components/price
-              label: Price
-            - href: /docs/components/rating
-              label: Rating
-            - href: /docs/components/section
-              label: Section
-            - href: /docs/components/theme-toggle
-              label: Theme Toggle
-            - href: /docs/components/tile
-              label: Tile
-            - href: /docs/components/toc
-              label: Toc
-            - href: /docs/components/typography
-              label: Typography
+            - href: /docs/rendering
+              label: Rendering

apps/docs/src/layouts/base.tsx

@@ -15,6 +15,7 @@ import { Posthog } from "@/components/posthog"
 import { Sidebar1 } from "@/components/blocks/sidebar-1"
 import { ThemeScript } from "@/components/ui/theme-toggle"
 import { globals } from "@/lib/globals"
+import { markdownPath } from "@/lib/markdown"
 import { theme } from "@/lib/theme"
 
 export type BaseLayoutProps = LayoutHeadProps & {
@@ -41,14 +42,15 @@ export default function BaseLayout({
         image={
           head.image || {
             src: "https://sitex.full.dev/social.png",
-            alt: "SiteX",
+            alt: globals.name,
             width: 1200,
             height: 630,
             type: "image/png",
           }
         }
       >
         <ThemeScript {...theme} />
+        <link rel="alternate" type="text/markdown" href={markdownPath(path)} />
       </LayoutHead>
       <LayoutBody>
         <Sidebar1

apps/docs/src/layouts/home.tsx

@@ -4,6 +4,7 @@ import type { WebSite, WithContext } from "schema-dts"
 import { Features1 } from "@/components/blocks/features-1"
 import { Hero1 } from "@/components/blocks/hero-1"
 import BaseLayout from "@/layouts/base"
+import { globals } from "@/lib/globals"
 
 type HomeData = {
   hero: {
@@ -30,13 +31,15 @@ export default function HomeLayout({
   type,
   updatedAt,
 }: LayoutProps<HomeData>) {
+  // Fulldev made Sitex; as creator rather than publisher it does not read
+  // as a second name for the site itself.
   const website: WithContext<WebSite> = {
     "@context": "https://schema.org",
     "@type": "WebSite",
-    name: title,
+    name: globals.name,
     description,
     url,
-    publisher: {
+    creator: {
       "@type": "Organization",
       name: "Fulldev",
       url: "https://full.dev",

apps/docs/src/lib/markdown.ts

@@ -0,0 +1,3 @@
+/** A page's Markdown version: /docs/pages at /docs/pages.md, the homepage at /index.md. */
+export const markdownPath = (path: string) =>
+  `${path.replace(/\/$/, "") || "/index"}.md`