docs(admin): update content management workflow documentation

Author: ComputelessComputer

apps/web/src/routes/admin/README.md

@@ -34,16 +34,30 @@ Import blog posts from published Google Docs with automatic HTML-to-Markdown con
 4. Fill in metadata (title, author, description, cover image)
 5. Select destination folder and save
 
-### Content Management (`/admin/content`)
+### Content Management (`/admin/collections`)
 
-Browse and view MDX content files across all content folders:
+Full-featured blog editor with the following capabilities:
 
-- Articles
-- Changelog
-- Documentation
-- Handbook
-- Legal
-- Templates
+- Create, edit, and manage blog articles
+- Rich text editor with Google Docs import
+- Metadata panel (title, author, date, description, category, cover image)
+- Preview mode with side-by-side editing
+- Git history tracking
+- Draft management with branch-based workflow
+
+#### Editorial Workflow
+
+When editing a published article:
+
+1. **Save** - Creates/updates a PR branch with `ready_for_review: false`
+2. **Submit for Review** - Updates the article with `ready_for_review: true` and adds a reviewer
+3. GitHub Actions detects the status and sends appropriate Slack notifications:
+   - Regular edits: "✏️ {user} made changes to {title}"
+   - Submitted for review: "👀 Article submitted for review" (tags reviewer)
+
+The `ready_for_review` field in frontmatter tracks the editorial state:
+- `false` (default): Article is being edited
+- `true`: Article is ready for content review
 
 ## API Endpoints
 
@@ -65,6 +79,17 @@ All API endpoints require admin authentication.
 ### Content APIs
 
 - `GET /api/admin/content/list` - List content files in a folder
+- `GET /api/admin/content/list-drafts` - List draft articles from branches
+- `GET /api/admin/content/pending-pr` - Check if article has a pending edit PR
+- `GET /api/admin/content/get-branch-file` - Get file content from a branch
+- `GET /api/admin/content/history` - Get git commit history for a file
+- `POST /api/admin/content/save` - Save content (creates PR for published articles)
+- `POST /api/admin/content/create` - Create new content file
+- `POST /api/admin/content/publish` - Publish/unpublish an article
+- `POST /api/admin/content/submit-for-review` - Submit article for editorial review
+- `POST /api/admin/content/rename` - Rename a content file
+- `POST /api/admin/content/duplicate` - Duplicate a content file
+- `POST /api/admin/content/delete` - Delete a content file
 
 ## Environment Variables