How to use & edit this wiki

This wiki is the single source of truth for how we run the glass business — SOPs, best practices, and flowcharts. It lives at wiki.bcbautoglass.com and is generated from a Git repository, so every change is versioned and nothing gets lost.

How it works

• The wiki is a static site (Astro Starlight) in the bcb-wiki GitHub repo.
• Pages are plain Markdown files under src/content/docs/.
• Pushing to main automatically rebuilds and publishes the site (Cloudflare Pages).
• Flowcharts are written as Mermaid code blocks right inside the Markdown — they render as diagrams on the page.

Editing pages (no coding required)

Option 1 — Pages CMS (recommended for the team):

1. Go to app.pagescms.org and log in with GitHub.
2. Open the bcb-wiki repo. You’ll see every wiki page listed.
3. Edit in the visual editor and hit Save — it commits for you, and the site republishes in about a minute.

Anyone who should edit the wiki needs a (free) GitHub account with access to the repo. Add people under the repo’s Settings → Collaborators.

Option 2 — “Edit page” link: every page has an Edit page link in the footer that opens the file on GitHub — edit and commit right in the browser.

Option 3 — ask Claude: Claude Code has full access to the repo and can write or restructure pages for you.

Adding a page

Create a new .md file in the right section folder (via Pages CMS or GitHub):

Section	Folder
Start Here	src/content/docs/start-here/
Lead Flow	src/content/docs/leads/
Marketing Websites	src/content/docs/websites/
Ops Dashboard	src/content/docs/ops-dashboard/
Best Practices	src/content/docs/best-practices/

Every page needs this at the top (Pages CMS fills it in for you):

---
title: My page title
description: One line that shows up in search.
---

New pages appear in the sidebar automatically. To add a whole new section, create the folder and add one line to the sidebar list in astro.config.mjs (or ask Claude).

Adding a flowchart

Add a fenced code block with the language mermaid:

```mermaid
flowchart TD
  A[Customer submits form] --> B[Email + text goes out]
  B --> C{Booked?}
  C -- Yes --> D[Schedule the job]
  C -- No --> E[Follow up]
```

flowchart TD
  A[Customer submits form] --> B[Email + text goes out]
  B --> C{Booked?}
  C -- Yes --> D[Schedule the job]
  C -- No --> E[Follow up]

House rules

• No passwords or API keys on this wiki, ever. Credentials live in the server .env, encrypted in the dashboard DB, or in a gitignored CLAUDE.local.md — never here.
• Keep pages task-shaped: someone should be able to follow a page top-to-bottom and get the job done.
• If you fix a process, fix the wiki page in the same sitting.