Terminal Workflow for Textbook Development

flowchart TD Start(("Open VS Code")):::startNode Terminal["Open Terminal
(Ctrl+`)"]:::termNode Serve["mkdocs serve
Start dev server"]:::mkdocsNode NeedScripts{"Need to run
Python scripts?"}:::decisionNode NewTerm["Create new terminal
(+)"]:::termNode Edit["Edit markdown files
Auto-reload in browser"]:::editNode Script["python docs/learning-graph/
analyze-graph.py"]:::scriptNode Quality{"Quality check
passed?"}:::decisionNode Fix["Fix identified issues"]:::editNode Commit["git add . && git commit
-m 'message'"]:::gitNode Push["git push origin main"]:::gitNode Deploy["mkdocs gh-deploy"]:::deployNode End(("Textbook Published")):::endNode Start --> Terminal Terminal --> Serve Serve --> NeedScripts NeedScripts -->|Yes| NewTerm NeedScripts -->|No| Edit NewTerm --> Edit Edit --> Script Script --> Quality Quality -->|No| Fix Fix --> Edit Quality -->|Yes| Commit Commit --> Push Push --> Deploy Deploy --> End classDef startNode fill:#667eea,stroke:#333,stroke-width:3px,color:#fff,font-size:16px classDef termNode fill:#4facfe,stroke:#333,stroke-width:2px,color:#fff,font-size:16px classDef mkdocsNode fill:#43aa8b,stroke:#333,stroke-width:2px,color:#fff,font-size:16px classDef decisionNode fill:#ffd166,stroke:#333,stroke-width:2px,color:#333,font-size:16px classDef editNode fill:#f77f00,stroke:#333,stroke-width:2px,color:#fff,font-size:16px classDef scriptNode fill:#06ffa5,stroke:#333,stroke-width:2px,color:#333,font-size:16px classDef gitNode fill:#764ba2,stroke:#333,stroke-width:2px,color:#fff,font-size:16px classDef deployNode fill:#f093fb,stroke:#333,stroke-width:2px,color:#fff,font-size:16px classDef endNode fill:#43aa8b,stroke:#333,stroke-width:3px,color:#fff,font-size:16px linkStyle default stroke:#999,stroke-width:2px,font-size:14px