# ShiftOps Documentation

**Last Updated:** 2026-01-09

**Note:** This documentation has been restructured into a modular format for better organization and maintainability.

## New Documentation Structure

ShiftOps documentation is now organized into focused modules:

📁 **`docs/guides/tools-pages/shiftops/`**

- **[README.md](shiftops/README.md)** - Main entry point with overview and navigation
- **[01-overview.md](shiftops/01-overview.md)** - Tool overview, purpose, use cases, target audience
- **[02-user-flow.md](shiftops/02-user-flow.md)** - Complete user flow with screenshots and diagrams
- **[03-technical-implementation.md](shiftops/03-technical-implementation.md)** - File structure, JavaScript modules, API endpoints
- **[04-scoring-system.md](shiftops/04-scoring-system.md)** - 5 pillars, formulas, calculations, examples
- **[05-api-endpoints.md](shiftops/05-api-endpoints.md)** - All API endpoints, request/response formats
- **[06-content-strategy.md](shiftops/06-content-strategy.md)** - Hero copy, FAQs, meta tags, schema markup
- **[07-testing-maintenance.md](shiftops/07-testing-maintenance.md)** - Testing procedures, maintenance checklist
- **[QUICK_REFERENCE.md](shiftops/QUICK_REFERENCE.md)** - Quick lookup for common tasks

## Why Modular Structure?

The previous monolithic documentation (1,015 lines) has been split into focused modules for:

- **Better Navigation:** Easier to find specific information
- **Easier Maintenance:** Update specific sections without navigating large files
- **Better Cross-References:** Link to system documentation without duplication
- **Improved Collaboration:** Multiple people can work on different sections
- **Version Control:** Smaller files show clearer diffs

## Quick Links

- [Start Here: README](shiftops/README.md)
- [User Flow with Diagrams](shiftops/02-user-flow.md)
- [Scoring System Formulas](shiftops/04-scoring-system.md)
- [API Reference](shiftops/05-api-endpoints.md)
- [Quick Reference](shiftops/QUICK_REFERENCE.md)

## Related Documentation

- [System Documentation](../../systems/shiftops/README.md) - Complete system documentation index
- [Tools Inventory](../TOOLS_INVENTORY.md) - Complete tools inventory

---

**Legacy Note:** This file is kept for backward compatibility. All new documentation work should use the modular structure in `shiftops/` directory.