Start doc reorg

.dockerignore

@@ -1,6 +1,21 @@
-.docusaurus
+# Build outputs
+website/.docusaurus
+website/build
+specs/tsp-output
 
-/build
-/node_modules
-/sites/*/build
-/sites/*/node_modules
+# Dependencies
+node_modules
+website/node_modules
+specs/node_modules
+tools/node_modules
+
+# Temporary files
+.git
+.env
+*.log
+package-lock.json
+
+# IDE and OS files
+.vscode
+.idea
+.DS_Store

.github/workflows/check-openapi-specs.yml

@@ -3,8 +3,8 @@ name: Check OpenAPI Specs
 on:
   pull_request:
     paths:
-      - 'api/**/tsp-output/@typespec/openapi3/openapi.yaml'
-      - 'api/**/_spec_.yaml'
+      - 'specs/**/tsp-output/@typespec/openapi3/openapi.yaml'
+      - 'specs/**/_spec_.yaml'
 
 permissions:
   contents: read
@@ -20,9 +20,20 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: '20'
+          cache: 'yarn'
 
       - name: Install dependencies
-        run: npm install typescript ts-node @types/node axios form-data
+        run: |
+          yarn install --frozen-lockfile
+          yarn add --dev ts-node -W
+          
+      - name: Debug working directory
+        run: |
+          echo "Current working directory: $(pwd)"
+          echo "Directory contents:"
+          ls -la
+          echo "Specs directory:"
+          ls -la specs/ || echo "specs directory not found"
           
       - name: Generate report
         id: generate-report
@@ -34,7 +45,7 @@ jobs:
         run: |
           echo "=== Starting Report Generation ==="
           # Run the script and capture stdout for the report
-          REPORT=$(npx ts-node scripts/generate-matrix.ts)
+          REPORT=$(yarn ts-node tools/scripts/generate-matrix.ts)
           EXIT_CODE=$?
           
           if [ $EXIT_CODE -ne 0 ]; then

.gitignore

@@ -1,36 +1,31 @@
 # Dependencies
 /node_modules
+website/node_modules
+specs/node_modules
+tools/node_modules
 
 # Production
 /build
+website/build
 
 # Generated files
 .docusaurus
+website/.docusaurus
+specs/tsp-output
 .claude
 .cache-loader
-/src/data/articles.json
-/static/attachments/unified-docs/unified-swml.md
-static/attachments/unified-docs/unified-swml.md
-
 
 # Misc
 .DS_Store
-.env.local
-.env.development.local
-.env.test.local
-.env.production.local
 .idea
 .history
 .cursorignore
 temp
+.env
 
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
 
-.env
 .cursorrules
-
 .cursor/notes
-
-.claude

.prettierignore

@@ -1,3 +1,20 @@
-build
-_spec_.yaml
-static
+# Build outputs
+website/build
+website/.docusaurus
+specs/tsp-output
+
+# Generated files
+**/_spec_.yaml
+**/tsp-output/**
+
+# Static assets
+website/static
+website/images
+
+# Dependencies
+node_modules
+**/node_modules
+
+# Versioned docs (auto-generated)
+**/*_versioned_docs
+**/*_versioned_sidebars

Dockerfile

@@ -1,13 +1,33 @@
 FROM node:20 AS builder
 WORKDIR /app
-COPY . /app
+
+# Set memory limit for Node.js operations
 ENV NODE_OPTIONS="--max-old-space-size=4096"
-RUN npm run install-ci && npm run build
 
+# Copy root package files first for better caching
+COPY package*.json ./
+COPY .yarnrc* ./
+
+# Copy workspace package.json files for dependency resolution
+COPY website/package*.json ./website/
+COPY specs/package*.json ./specs/
+COPY tools/package*.json ./tools/
+
+# Copy source code (needed for postinstall build)
+COPY website ./website
+COPY specs ./specs
+COPY tools ./tools
+
+# Install dependencies and run postinstall (builds specs and website)
+RUN yarn install --frozen-lockfile
+
+# Switch to website directory for final output
+WORKDIR /app/website
 
+# Production stage
 FROM nginx
-COPY provisioning/nginx/nginx.conf /etc/nginx/nginx.conf
-COPY provisioning/nginx/redirects.map /etc/nginx/redirects.map
-COPY --from=builder /app/build/ /usr/share/nginx/html
+COPY --from=builder /app/website/provisioning/nginx/nginx.conf /etc/nginx/nginx.conf
+COPY --from=builder /app/website/provisioning/nginx/redirects.map /etc/nginx/redirects.map
+COPY --from=builder /app/website/build/ /usr/share/nginx/html
 
 EXPOSE 80

netlify.toml

@@ -1,11 +1,13 @@
 # Global settings applied to the whole site.
 [build]
+  base = "website/"
   command = "npm i && npm run build"
   publish = "build/"
   environment = { NODE_VERSION = "20", NODE_OPTIONS = "--max_old_space_size=4096", WEBPACK_URL_LOADER_LIMIT = "512" }
 
 # All deploys from the main branch
 # will inherit these settings.
 [context.main]
+  base = "website/"
   command = "echo Skipping build && mkdir empty"
   publish = "empty/"