Source: Jolli-sample-repos/url-shortener Last Updated: 4/8/2026

Documentation Sites

This repo contains two Docusaurus documentation sites for comparison:

aidan-doc - Manually reviewed/edited documentation
claude-doc - AI-generated documentation

Running the Documentation Sites

Prerequisites

Node.js 16+
npm 7+

Installation & Setup

Each documentation site needs dependencies installed:


# Install aidan-doc dependencies
cd aidan-doc && npm install
 
# Install claude-doc dependencies
cd ../claude-doc && npm install

Running Both Sites

Run each site in a separate terminal:


# Terminal 1 - Run aidan-doc
cd aidan-doc && npm start
# Runs on http://localhost:3000
 
# Terminal 2 - Run claude-doc
cd claude-doc && npm start
# Runs on http://localhost:3001

Building for Production


# Build aidan-doc
cd aidan-doc && npm run build
 
# Build claude-doc
cd claude-doc && npm run build

Built files will be in each project’s build/ directory.

Troubleshooting

Port already in use:


# Kill process on port 3000 (Windows)
netstat -ano | findstr :3000
taskkill //F //PID <PID>
 
# Or run on different port
npm start -- --port 3002

Missing dependencies:


cd aidan-doc  # or claude-doc
rm -rf node_modules package-lock.json
npm install

Cache issues:


cd aidan-doc  # or claude-doc
rm -rf .docusaurus node_modules/.cache
npm start