Update documentation.

* Clean up and create placeholders for future documentation.

Author: natebass

README.md

@@ -1,65 +1,60 @@
-# Open Fresno Storybook (Next.js)
+# Open Fresno website documentation
 
-This repository hosts the **Storybook + Next.js testing environment** for Open Fresno. It provides a sandbox for building, documenting, and testing UI components in isolation before they are integrated into the main site. The main repository is https://github.com/openfresno/openfresno.org.
+This repository hosts the **Storybook + Next.js testing environment** for the Open Fresno website. It provides a sandbox
+for building, documenting, and testing UI components in isolation before they are integrated into the main site.
 
-## Get Started
-
-### Prerequisites
-
-- Node.js
-- PNPM
-
-### Installation
+> [!NOTE]
+> The Open Fresno website repository
+> is [github.com/openfresno/openfresno.org](https://github.com/openfresno/openfresno.org).
 
-Clone the repo and install dependencies:
+> [!WARNING]
+> The code should be periodically kept up to date with the main repository by manually copy/pasting the `src/` folder.
 
-```
-git clone https://github.com/openfresno/fe-openfresno-doc
-cd fe-openfresno-doc
-pnpm i
-```
+## Prerequisites
 
-### Running Storybook
+- PNPM. Get help installing
+  PNPM [here](https://openfresno.github.io/fe-openfresno.org-doc/?path=/docs/developer-guide--docs#install-pnpm)
+  or https://pnpm.io/installation.
 
-Start the Storybook development server:
+## Get Started
 
-```
-pnpm run storybook
-```
+1. Install the Node.js dependencies.
 
-Storybook will be available at **http://localhost:6006**.
+   ```
+   pnpm i
+   ```
 
-### Running Next.js
+2. Start the Storybook development server.
 
-The regular website can be previewed as well.
+   ```
+   pnpm storybook
+   ```
 
-> [!NOTE]
-> The code should be periodically kept up to date with the main repository by manually copy/pasting the `src/` folder.
+3. (Optional) Preview the regular Next.js website.
 
-```
-pnpm run dev
-```
+   ```
+   pnpm dev
+   ```
 
 ## Testing
 
-This repo is designed for component-driven development. We use:
+### Storybook
+
+The public Storybook is deployed to GitHub Pages at https://openfresno.github.io/fe-openfresno.org-doc/. You can learn
+about the components and also run tests.
 
-- **Storybook** for isolated UI development
-- **Vitest** for unit tests
-- **Playwright** for visual regression and interaction tests
+### Playwright
 
-## Contribute
+Visual regression and interaction tests. These tests also contain critical tests that should be included in the main
+website repository for use in CI/CD pipelines.
 
-We welcome contributions! Here are a few ways to help:
+### Vitest
 
-1. Look for Issues tagged `help wanted` or `good first issue`.
-2. Add or improve component stories to increase coverage.
-3. Write tests for new components or edge cases.
-4. Submit a pull request with clear commit messages.
+Unit tests and coverage.
 
 ## Resources
 
-- [Storybook Docs](https://storybook.js.org/docs/ "null")
-- [Next.js Docs](https://nextjs.org/docs "null")
-- [React Testing Library](https://testing-library.com/docs/react-testing-library/intro/ "null")
-- [Code of Conduct](https://www.google.com/search?q=https://github.com/openfresno/fe-openfresno-doc/blob/main/CODE_OF_CONDUCT.md "null")
+- [Contributing guide](https://github.com/openfresno/openfresno.org/blob/main/CONTRIBUTING.md)
+- [Open Fresno's Code of Conduct](https://www.google.com/search?q=https://github.com/openfresno/fe-openfresno-doc/blob/main/CODE_OF_CONDUCT.md)
+- [Storybook documentation](https://storybook.js.org/docs)
+- [Next.js documentation](https://nextjs.org/docs)

src/stories/FileStructure.mdx src/stories/DeveloperGuide.mdxsrc/stories/FileStructure.mdx renamed to src/stories/DeveloperGuide.mdx

@@ -1,16 +1,20 @@
 import { Meta } from "@storybook/addon-docs/blocks";
 
-<Meta title="File Structure" />
+<Meta title="Developer Guide" />
+
+# Developer Guide
+
+## Install PNPM
 
 ## 📂 Open Fresno website project structure
 
 - public/ — Shared UI components
 - src/app/ — Next.js pages (for integration testing)
 - src/components/layout — Layout components (base layout, navbar, footer).
 - src/components/ui — Custom UI components.
-  - src/components/index.js — All UI components are available through this index.js. Example: import \{ thing \} from "@/components/ui"
-  - src/components/ui/icon — Custom-made icons (put third-party in integrations).
-  - src/components/ui/timeline —
+- src/components/index.js — All UI components are available through this index.js. Example: import \{ thing \} from "@/components/ui"
+- src/components/ui/icon — Custom-made icons (put third-party in integrations).
+- src/components/ui/timeline —
 - src/integrations/ — Integration with external services
 - src/utility/ — Utility functions and helpers
 - styles/ — **DEPRECATED**: SCSS styles. Use src/app/-styles/main.css.

src/stories/StyleGuideContributing.mdx src/stories/StyleGuide.mdxsrc/stories/StyleGuideContributing.mdx renamed to src/stories/StyleGuide.mdx

@@ -20,7 +20,7 @@ export const RightArrow = () => (
   </svg>
 );
 
-<Meta title="Style Guide Contributing" />
+<Meta title="Style Guide" />
 
 <div className="sb-container">
   <div className="sb-section-title">