Polish sitewide marketing navigation and content

docs-site/README.md

@@ -1,6 +1,16 @@
 # Row-Bot Docs Site
 
-This Docusaurus site is a review-only public documentation build. It is not wired into the current public website and is not published by CI.
+This Docusaurus project is the source for Row-Bot's public documentation. Its
+build is synchronized into the generated documentation-owned paths under
+`docs/`, which GitHub Pages publishes alongside the hand-curated marketing
+pages at the site root.
+
+Do not edit generated files under `docs/docs`, `docs/assets`, `docs/img`,
+`docs/pagefind`, or `docs/search` by hand. Change this source and use the
+documented build/synchronization workflow. The root marketing files
+(`index.html`, `features.html`, `architecture.html`, `contact.html`,
+`404.html`, `site.css`, `site.js`, and their media) are deliberately outside
+the synchronization script's ownership.
 
 ## Local Preview
 

docs-site/docusaurus.config.ts

@@ -2,6 +2,12 @@ import type {Config} from '@docusaurus/types';
 import type * as Preset from '@docusaurus/preset-classic';
 
 const landingPageUrl = 'https://row-bot.ai/';
+const installationUrl = 'https://row-bot.ai/#install';
+const marketingSitemapUrls = [
+  'https://row-bot.ai/features.html',
+  'https://row-bot.ai/architecture.html',
+  'https://row-bot.ai/contact.html',
+];
 
 const config: Config = {
   title: 'Row-Bot',
@@ -41,6 +47,20 @@ const config: Config = {
         theme: {
           customCss: './src/css/custom.css',
         },
+        sitemap: {
+          async createSitemapItems({
+            routes,
+            siteConfig,
+            defaultCreateSitemapItems,
+          }) {
+            const docsItems = await defaultCreateSitemapItems({routes, siteConfig});
+            const existingUrls = new Set(docsItems.map((item) => item.url));
+            const marketingItems = marketingSitemapUrls
+              .filter((url) => !existingUrls.has(url))
+              .map((url) => ({url}));
+            return [...docsItems, ...marketingItems];
+          },
+        },
       } satisfies Preset.Options,
     ],
   ],
@@ -76,7 +96,7 @@ const config: Config = {
           position: 'right',
         },
         {
-          href: landingPageUrl,
+          href: installationUrl,
           label: 'Download',
           position: 'right',
           target: '_self',
@@ -86,6 +106,16 @@ const config: Config = {
     footer: {
       style: 'dark',
       links: [
+        {
+          title: 'Row-Bot',
+          items: [
+            {label: 'Home', href: landingPageUrl},
+            {label: 'Features', href: 'https://row-bot.ai/features.html'},
+            {label: 'Architecture', href: 'https://row-bot.ai/architecture.html'},
+            {label: 'Contact', href: 'https://row-bot.ai/contact.html'},
+            {label: 'Blog', href: 'https://sydsachar.com/category/row-bot/'},
+          ],
+        },
         {
           title: 'Docs',
           items: [

docs-site/src/pages/index.tsx

@@ -22,7 +22,7 @@ export default function Home(): JSX.Element {
             </Link>
             <Link
               className="button button--secondary button--lg"
-              href="https://row-bot.ai/"
+              href="https://row-bot.ai/#install"
             >
               Download
             </Link>