# Documentation Master Index

**Last Updated:** 2026-04-01

Complete master index of all Ordio documentation organized by category and purpose. Use this index to quickly find relevant documentation for any task.

## Quick Navigation

- **[Getting Started](#getting-started)** - New to the project? Start here
- **[AI & Cursor Rules](#ai--cursor-rules)** - Cursor AI configuration and rule management
- **[Guides](#guides)** - How-to guides and workflows
- **[Content Documentation](#content-documentation)** - Content creation, blog, pages
- **[Systems Documentation](#systems-documentation)** - System architecture and features
- **[Development](#development)** - Development guidelines and best practices
- **[Reference](#reference)** - API references, architecture, standards
- **[Analysis & Strategy](#analysis--strategy)** - SEO strategy, analysis reports
- **[Standards & Maintenance](#standards--maintenance)** - Documentation standards and maintenance

---

## Getting Started

**For new team members or AI agents:**

- **[QUICK_START.md](QUICK_START.md)** - Quick start guide for the project
- **[README.md](README.md)** - Main documentation overview
- **[ONBOARDING.md](ONBOARDING.md)** - Onboarding guide
- **[DOCUMENTATION_STANDARDS.md](DOCUMENTATION_STANDARDS.md)** - Documentation conventions and standards

**Key Resources:**

- **[DOCUMENTATION_INVENTORY.md](DOCUMENTATION_INVENTORY.md)** - Complete inventory of all documentation files
- **[DOCUMENTATION_HYGIENE_LOG.md](DOCUMENTATION_HYGIENE_LOG.md)** — Documentation maintenance SSOT + changelog
- **[Rule to Documentation Mapping](ai/RULE_TO_DOC_MAPPING.md)** - Mapping between Cursor rules and documentation

---

## AI & Cursor Rules

**Cursor AI Configuration:**

- **[ai/README.md](ai/README.md)** - AI documentation index
- **[ai/cursor-playbook.md](ai/cursor-playbook.md)** - Complete workflow guide for Cursor
- **[ai/RULE_TO_DOC_MAPPING.md](ai/RULE_TO_DOC_MAPPING.md)** - Bidirectional mapping between rules and docs
- **[ai/rule-hierarchy.md](ai/rule-hierarchy.md)** - Rule architecture and decision tree
- **[ai/CURSOR_MODEL_CONFIGURATION.md](ai/CURSOR_MODEL_CONFIGURATION.md)** - Model configuration guide

**Rule Discovery & Patterns:**

- **[ai/RULE_DISCOVERY_PATTERNS.md](ai/RULE_DISCOVERY_PATTERNS.md)** - How to discover relevant rules
- **[ai/RULE_DEPENDENCY_GRAPH.md](ai/RULE_DEPENDENCY_GRAPH.md)** - Rule dependency relationships
- **[ai/SEMANTIC_SEARCH_INDEX.md](ai/SEMANTIC_SEARCH_INDEX.md)** - Semantic search patterns

**Cursor Rules Location:**

- **Rules Directory:** `.cursor/rules/` (see [DOCUMENTATION_INVENTORY.md](DOCUMENTATION_INVENTORY.md) for current `.mdc` count)
- **Metadata Index:** `docs/ai/METADATA_INDEX.json` - Machine-readable rule metadata

---

## Guides

**Page Type Guides:**

- **[guides/PAGE_TYPE_GUIDES.md](guides/PAGE_TYPE_GUIDES.md)** - Quick reference for all page types
- **[guides/comparison-pages/COMPARISON_PAGES_GUIDE.md](guides/comparison-pages/COMPARISON_PAGES_GUIDE.md)** - Comparison page creation guide
- **[guides/tools-pages/README.md](guides/tools-pages/README.md)** - Tools/calculator pages documentation

**Integration Guides:**

- **[guides/HUBSPOT_INTEGRATION_GUIDE.md](guides/HUBSPOT_INTEGRATION_GUIDE.md)** - HubSpot integration patterns
- **[forms/FORM_TRACKING_BEST_PRACTICES.md](forms/FORM_TRACKING_BEST_PRACTICES.md)** - Form tracking guidelines

**Content Guides:**

- **[content/CONTENT_WRITING_BEST_PRACTICES_2026.md](content/CONTENT_WRITING_BEST_PRACTICES_2026.md)** - Content writing standards
- **[content/CONTENT_STRUCTURE_FORMATTING_GUIDE.md](content/CONTENT_STRUCTURE_FORMATTING_GUIDE.md)** - Content structure guidelines

---

## Content Documentation

### Blog System

- **[content/blog/FINAL_STATUS.md](content/blog/FINAL_STATUS.md)** - Current blog system status
- **[content/blog/PRODUCTION_WORKFLOW_GUIDE.md](content/blog/PRODUCTION_WORKFLOW_GUIDE.md)** - Blog production workflow
- **[content/blog/BACKUP_SYSTEM_OVERVIEW.md](content/blog/BACKUP_SYSTEM_OVERVIEW.md)** - Blog backup procedures

**Blog Guides:**

- **[content/blog/guides/](content/blog/guides/)** - Blog-specific guides and workflows
- **[content/blog/reference/](content/blog/reference/)** - Blog system reference documentation

### Page Documentation

- **[content/pages/README.md](content/pages/README.md)** - Pages documentation overview
- **[content/pages/MASTER_PAGES_INDEX.md](content/pages/MASTER_PAGES_INDEX.md)** - Complete page inventory
- **[content/pages/DOCUMENTATION_STRUCTURE.md](content/pages/DOCUMENTATION_STRUCTURE.md)** - Page documentation structure

**Page Type Inventories:**

- **[content/pages/product-pages/PRODUCT_PAGES_INVENTORY.md](content/pages/product-pages/PRODUCT_PAGES_INVENTORY.md)** - Product pages list
- **[content/pages/comparison-pages/COMPARISON_PAGES_INVENTORY.md](content/pages/comparison-pages/COMPARISON_PAGES_INVENTORY.md)** - Comparison pages list
- **[content/pages/industry-pages/INDUSTRY_PAGES_INVENTORY.md](content/pages/industry-pages/INDUSTRY_PAGES_INVENTORY.md)** - Industry pages list

### Content Writing

- **[content/CONTENT_WRITING_BEST_PRACTICES_2026.md](content/CONTENT_WRITING_BEST_PRACTICES_2026.md)** - Writing standards
- **[content/AI_CONTENT_AVOIDANCE_GUIDE.md](content/AI_CONTENT_AVOIDANCE_GUIDE.md)** - Avoiding AI-generated content patterns
- **[content/META_TAGS_OPTIMIZATION_GUIDE.md](content/META_TAGS_OPTIMIZATION_GUIDE.md)** - Meta tag optimization

---

## Systems Documentation

**System Overviews:**

- **[systems/README.md](systems/README.md)** - Systems documentation index

**Key Systems:**

- **[systems/shiftops/README.md](systems/shiftops/README.md)** - ShiftOps analyzer system
- **[systems/product-updates/README.md](systems/product-updates/README.md)** - Product Updates CMS
- **[systems/excel-generator/README.md](systems/excel-generator/README.md)** - Excel template generator
- **[systems/partner-pages/PARTNER_PAGES_GUIDE.md](systems/partner-pages/PARTNER_PAGES_GUIDE.md)** - Partner landing pages
- **[systems/landing-page-redirects/LANDING_PAGE_REDIRECTS.md](systems/landing-page-redirects/LANDING_PAGE_REDIRECTS.md)** - Landing page redirects

---

## Development

**Development Guidelines:**

- **[development/PHP_EXTENSION_DEPENDENCIES.md](development/PHP_EXTENSION_DEPENDENCIES.md)** - PHP extension requirements
- **[development/JAVASCRIPT_LOGGING_BEST_PRACTICES.md](development/JAVASCRIPT_LOGGING_BEST_PRACTICES.md)** - JavaScript logging standards
- **[development/PRODUCTION_DEPLOYMENT_CHECKLIST.md](development/PRODUCTION_DEPLOYMENT_CHECKLIST.md)** - Deployment checklist
- **[development/CURSOR_INDEXING_SETUP.md](development/CURSOR_INDEXING_SETUP.md)** - Cursor indexing and ignore configuration
- **[development/CURSOR_INDEXING_OPTIMIZATION.md](development/CURSOR_INDEXING_OPTIMIZATION.md)** - Index optimization plan

**Performance:**

- **[performance/](performance/)** - Performance optimization guides
- **[performance-optimization/](performance-optimization/)** - Performance optimization documentation

**Forms & APIs:**

- **[forms/](forms/)** - Form tracking and integration guides
- **[reference/api/](reference/api/)** - API reference documentation

---

## Reference

**API Reference:**

- **[reference/api/README.md](reference/api/README.md)** - API documentation index
- **[reference/api/STANDARDIZED_API_HELPERS.md](reference/api/STANDARDIZED_API_HELPERS.md)** - API helper patterns

**Architecture:**

- **[reference/architecture/README.md](reference/architecture/README.md)** - Architecture documentation
- **[reference/architecture/full-site/SITE_ARCHITECTURE.md](reference/architecture/full-site/SITE_ARCHITECTURE.md)** - Complete site architecture
- **[reference/architecture/content-clusters/](reference/architecture/content-clusters/)** - Content cluster strategy

**Standards:**

- **[DOCUMENTATION_STANDARDS.md](DOCUMENTATION_STANDARDS.md)** - Documentation conventions
- **[DATE_MANAGEMENT_GUIDELINES.md](DATE_MANAGEMENT_GUIDELINES.md)** - Date formatting standards

---

## Analysis & Strategy

**SEO Strategy:**

- **[seo-strategy-2026/README.md](seo-strategy-2026/README.md)** - SEO Strategy 2026 overview
- **[seo-strategy-2026/NEXT_STEPS.md](seo-strategy-2026/NEXT_STEPS.md)** - Next steps and priorities

**Analysis Reports:**

- **[analysis/](analysis/)** - Analysis reports and findings
- **[audit/](audit/)** - Audit reports

**Strategy Documents:**

- **[strategy-2026/](strategy-2026/)** - Strategy 2026 documentation

---

## Standards & Maintenance

**Documentation Standards:**

- **[DOCUMENTATION_STANDARDS.md](DOCUMENTATION_STANDARDS.md)** - Complete documentation standards
- **[DOCUMENTATION_MAINTENANCE_PROCESS.md](DOCUMENTATION_MAINTENANCE_PROCESS.md)** - Maintenance workflows
- **[DOCUMENTATION_HYGIENE_LOG.md](DOCUMENTATION_HYGIENE_LOG.md)** — Changelog + archived meta-doc index
- **[DOCUMENTATION_SCALE_AND_SCOPE.md](DOCUMENTATION_SCALE_AND_SCOPE.md)** — Tracked vs gitignored volume; blog pipeline vs meta-docs
- **[DATE_MANAGEMENT_GUIDELINES.md](DATE_MANAGEMENT_GUIDELINES.md)** - Date management standards

**Documentation quality:**

- **[DOCUMENTATION_INVENTORY.md](DOCUMENTATION_INVENTORY.md)** — Generated inventory (`make docs-inventory`)
- **[DOCUMENTATION_REDUNDANCY_REPORT.md](DOCUMENTATION_REDUNDANCY_REPORT.md)** — Redundancy analysis (`make docs-redundancy`)
- **[archive/2026-04-01-docs-cleanup/stale-docs-root/](archive/2026-04-01-docs-cleanup/stale-docs-root/)** — Archived cleanup audits, gap matrices, validation snapshots (see README there)

**Validation (common):**

- `python3 scripts/documentation/validate-rules.py` → [RULE_VALIDATION_REPORT.md](RULE_VALIDATION_REPORT.md)
- `python3 scripts/documentation/validate-links.py` → [LINK_VALIDATION_REPORT.md](LINK_VALIDATION_REPORT.md)

---

## Archive

**Historical Documentation:**

- **[archive/](archive/)** - Archived documentation (historical reference)
- **Git History:** Use `git log` to access deleted archived files

---

## Related Cursor Rules

When working with documentation, the following Cursor rules apply:

- **[global.mdc](.cursor/rules/global.mdc)** - Planning requirements, research checklists, documentation standards (always applies)
- **[shared-patterns.mdc](.cursor/rules/shared-patterns.mdc)** - Universal validation checklist and shared patterns
- **[date-management.mdc](.cursor/rules/date-management.mdc)** - Date management standards
- **[content-writing.mdc](.cursor/rules/content-writing.mdc)** - Content writing guidelines

---

## Quick Reference

**Most Frequently Used:**

1. **[QUICK_START.md](QUICK_START.md)** - Getting started
2. **[DOCUMENTATION_STANDARDS.md](DOCUMENTATION_STANDARDS.md)** - Standards and conventions
3. **[ai/cursor-playbook.md](ai/cursor-playbook.md)** - Cursor workflow guide
4. **[guides/PAGE_TYPE_GUIDES.md](guides/PAGE_TYPE_GUIDES.md)** - Page type quick reference
5. **[content/blog/FINAL_STATUS.md](content/blog/FINAL_STATUS.md)** - Blog system status

**For AI Agents:**

- **[ai/RULE_TO_DOC_MAPPING.md](ai/RULE_TO_DOC_MAPPING.md)** - Rule-to-documentation mapping
- **[ai/RULE_DISCOVERY_PATTERNS.md](ai/RULE_DISCOVERY_PATTERNS.md)** - How to discover rules
- **[docs/ai/METADATA_INDEX.json](../docs/ai/METADATA_INDEX.json)** - Machine-readable rule metadata

---

**Last Updated:** 2026-04-01  
**Maintained By:** Documentation Team  
**Questions?** See [DOCUMENTATION_STANDARDS.md](DOCUMENTATION_STANDARDS.md) or [CONTRIBUTING.md](CONTRIBUTING.md)
