update for latest start9 me

Author: MattDHill

CONTRIBUTING.md

@@ -0,0 +1,58 @@
+# Contributing
+
+We welcome contributions! Whether you spot a typo or want to suggest new content, you can fork this project and submit a PR. If you are uncomfortable with this process, please [create an issue](https://github.com/Start9Labs/docs/issues).
+
+If you'd like to get started contributing to open source software, it's easier than you think! Visit one of our [Community Channels](https://start9.com/contact) and we'll help you get started.
+
+## Local Development
+
+1. Install dependencies
+
+   [Rust](https://rustup.rs)
+
+   ```
+   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
+   ```
+
+   [mdBook](https://rust-lang.github.io/mdBook/)
+
+   ```
+   cargo install mdbook
+   ```
+
+2. Clone the repo
+
+   ```
+   git clone https://github.com/Start9Labs/docs.git && cd docs
+   ```
+
+3. Serve locally
+
+   ```
+   ./serve.sh
+   ```
+
+   This builds the project and opens your browser at http://localhost:3000.
+
+## Project Structure
+
+```
+docs/
+├── src/              # Markdown source files (the actual documentation)
+├── theme/            # Custom CSS and JS (styling, Start Bot widget)
+├── widget/           # Start Bot chat widget (TypeScript, built by CI)
+├── scripts/          # Documentation indexing script for RAG
+├── book.toml         # mdBook configuration
+└── serve.sh          # Local development server
+```
+
+## Writing Docs
+
+- All documentation lives in `src/` as Markdown files
+- The sidebar structure is defined in `src/SUMMARY.md`
+- mdBook supports [admonitions](https://tommilligan.github.io/mdbook-admonish/) for warnings, tips, etc.
+- Use relative links between pages
+
+## Third Party Plugins
+
+[External link to mdBook plugins](https://github.com/rust-lang/mdBook/wiki/Third-party-plugins)

README.md

@@ -1,47 +1,19 @@
-# Start9 Documentation
+# StartOS Docs
 
-Welcome to the Start9 Docs! Here you will find the StartOS user manual, as well as integration guides, FAQ, support, knowledge base, and developer docs.
+The official documentation for [StartOS](https://start9.com) — covering setup, services, networking, troubleshooting, developer guides, and more.
 
-## Dependencies
+**Live site:** [docs.start9.com](https://docs.start9.com)
 
-1. [node](https://nodejs.org/en/)
+## Overview
 
-2. [npm](https://www.npmjs.com/get-npm)
- 
-3. Rust
+Built with [mdBook](https://rust-lang.github.io/mdBook/) and deployed to GitHub Pages. Includes an embedded [Start Bot](widget/) chat widget that provides AI-powered support using RAG (retrieval-augmented generation) over the documentation content.
 
-   ```
-   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
-   ```
+## How It Works
 
-4. [mdBook](https://rust-lang.github.io/mdBook/) - Documentation framework
-   
-   ```
-   cargo install mdbook
-   ```
+- Documentation is written in Markdown under `src/`
+- On push to `master`, GitHub Actions builds the site, deploys to Pages, and indexes the content for Start Bot
+- The indexing step chunks the Markdown by headings, generates vector embeddings via [Voyage AI](https://www.voyageai.com/), and sends them to the [start9-me](https://github.com/Start9Labs/start9-me) server for semantic search
 
-## Building
+## Getting Started
 
-1. Clone the repo and change into its directory
-
-   ```
-   git clone https://github.com/Start9Labs/docs.git && cd docs
-   ```
-
-2. Run the serve script
-
-   ```
-   ./serve
-   ```
-
-   This will automatically build the project and open your default web browser at http://localhost:3000
-
-## Contributing
-
-We love contributions! Whether you spot a typo or want to make suggestions, you can fork this project and submit a PR with your changes for consideration. If you are uncomfortable with this process, please [create an issue](https://github.com/Start9Labs/docs/issues).
-
-If you'd like to get started contributing to open source software, it's easier than you think! Visit one of our [Community Channels](https://start9.com/contact) and we'll help you get started.
-
-## Third party plugins
-
-[External link to plugins](https://github.com/rust-lang/mdBook/wiki/Third-party-plugins)
+See [CONTRIBUTING.md](CONTRIBUTING.md) for local development setup and contribution guidelines.

scripts/index-docs.ts

@@ -1,7 +1,7 @@
 export {};
 
 /**
- * Index StartOS documentation for AIDN
+ * Index StartOS documentation for Start Bot
  *
  * This script goes in the docs repo at scripts/index-docs.ts
  *

theme/docs-agent-init.js

@@ -1,5 +1,5 @@
 // Start9 Docs Agent Widget Configuration
 window.DocsAgentConfig = {
-  apiBaseUrl: 'https://start9.me/_api/docs',
+  apiBaseUrl: 'https://start9.me/_api/chat',
   position: 'bottom-right'
 };

widget/src/index.ts

@@ -271,7 +271,7 @@ class DocsAgentWidget {
     return `
       <div class="da-panel">
         <div class="da-header">
-          <span class="da-title">AIDN</span>
+          <span class="da-title">Start Bot</span>
           <div class="da-header-actions">
             ${
               this.session
@@ -314,7 +314,7 @@ class DocsAgentWidget {
           <path d="M19 17v4"/>
           <path d="M17 19h4"/>
         </svg>
-        <h3>Meet AIDN</h3>
+        <h3>Meet Start Bot</h3>
         <p>Your AI assistant for all things StartOS. Enter your support access code to start chatting.</p>
       </div>
       <form class="da-code-form">
@@ -337,7 +337,7 @@ class DocsAgentWidget {
     const messagesHtml =
       this.messages.length === 0
         ? `<div class="da-welcome">
-        <p>Hi, I'm AIDN. Ask me anything about StartOS.</p>
+        <p>Hi, I'm Start Bot. Ask me anything about StartOS.</p>
       </div>`
         : this.messages.map((m) => this.renderMessage(m)).join("");