Merge pull request #329 from Data-Wise/dev

Post-release doc fixes: emoji rendering, broken links, badges

Author: Data-Wise

README.md

@@ -1,6 +1,6 @@
 # flow-cli
 
-[![Version](https://img.shields.io/badge/version-6.1.0-blue.svg)](https://github.com/Data-Wise/flow-cli/releases/tag/v6.1.0)
+[![Version](https://img.shields.io/badge/version-6.2.0-blue.svg)](https://github.com/Data-Wise/flow-cli/releases/tag/v6.2.0)
 [![Tests](https://github.com/Data-Wise/flow-cli/actions/workflows/test.yml/badge.svg)](https://github.com/Data-Wise/flow-cli/actions)
 [![Docs](https://img.shields.io/badge/docs-online-brightgreen.svg)](https://data-wise.github.io/flow-cli/)
 

docs/architecture/DOCTOR-TOKEN-ARCHITECTURE.md

@@ -676,7 +676,6 @@ Cache Performance:
 
 - [API Reference](../reference/MASTER-API-REFERENCE.md#doctor-cache)
 - [User Guide](../guides/DOCTOR-TOKEN-USER-GUIDE.md)
-- [Phase 1 Spec](../specs/SPEC-flow-doctor-dot-enhancement-2026-01-23.md)
 - [Test Suites](../../tests/)
 
 ---

docs/contributing/index.md

@@ -8,7 +8,8 @@ tags:
 > **Help make flow-cli better — code, docs, tests, or ideas.**
 
 !!! tldr "Quick Start"
-    Read the [Developer Guide](../guides/DEVELOPER-GUIDE.md) and [Branch Workflow](BRANCH-WORKFLOW.md) before your first PR.
+    Read the [Developer Guide](../guides/DEVELOPER-GUIDE.md) and [Branch Workflow](BRANCH-WORKFLOW.md)
+    before your first PR.
 
 ---
 
@@ -53,7 +54,7 @@ tags:
 ## What's Here
 
 | Page | Description |
-|------|-------------|
+| ---- | ----------- |
 | [Developer Guide](../guides/DEVELOPER-GUIDE.md) | Architecture and coding standards |
 | [Contributing](CONTRIBUTING.md) | Contribution guidelines |
 | [Branch Workflow](BRANCH-WORKFLOW.md) | Git workflow for contributors |

docs/getting-started/index.md

@@ -57,7 +57,7 @@ tags:
 ## What's Here
 
 | Page | Description |
-|------|-------------|
+| ---- | ----------- |
 | [Choose Your Path](choose-your-path.md) | Guided learning path selector |
 | [Quick Start](quick-start.md) | 5-minute install + first session |
 | [Installation](installation.md) | All installation methods |

docs/guides/DOCTOR-TOKEN-USER-GUIDE.md

@@ -616,7 +616,6 @@ doctor --dot=github,npm,pypi  # Specific tokens
 ### Learn More
 
 - [API Reference](../reference/MASTER-API-REFERENCE.md#doctor-cache) - Complete API documentation
-- [Phase 1 Spec](../specs/SPEC-flow-doctor-dot-enhancement-2026-01-23.md) - Implementation details
 - [Test Suites](../../tests/) - Usage examples in tests
 
 ### Related Commands

docs/guides/DOTFILE-MANAGEMENT.md

@@ -861,7 +861,6 @@ grep github-token ~/.gitconfig
 ## See Also
 
 - [DOT-DISPATCHER-REFERENCE.md](../reference/MASTER-DISPATCHER-GUIDE.md#dot-dispatcher) - Complete command reference
-- [SECRET-MANAGEMENT.md](../SECRET-MANAGEMENT.md) - Deep dive into Bitwarden integration
 - [Chezmoi Documentation](https://www.chezmoi.io/) - Official chezmoi docs
 - [Bitwarden CLI Documentation](https://bitwarden.com/help/cli/) - Official Bitwarden CLI docs
 

docs/guides/index.md

@@ -61,7 +61,7 @@ tags:
 ## What's Here
 
 | Page | Description |
-|------|-------------|
+| ---- | ----------- |
 | [Start Here](00-START-HERE.md) | Orientation for new users |
 | [Quick Wins](WORKFLOWS-QUICK-WINS.md) | Low-effort, high-impact improvements |
 | [Git Feature Flow](../tutorials/08-git-feature-workflow.md) | Branch-based feature development |

docs/index.md

@@ -7,7 +7,7 @@ tags:
 
 # Flow CLI
 
-[![Version](https://img.shields.io/badge/version-v6.1.0-blue)](https://github.com/Data-Wise/flow-cli/releases/tag/v6.1.0)
+[![Version](https://img.shields.io/badge/version-v6.2.0-blue)](https://github.com/Data-Wise/flow-cli/releases/tag/v6.2.0)
 [![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
 [![Tests](https://img.shields.io/github/actions/workflow/status/Data-Wise/flow-cli/test.yml?label=tests&branch=main)](https://github.com/Data-Wise/flow-cli/actions/workflows/test.yml)
 [![Docs](https://img.shields.io/github/actions/workflow/status/Data-Wise/flow-cli/docs.yml?label=docs&branch=main)](https://github.com/Data-Wise/flow-cli/actions/workflows/docs.yml)
@@ -26,9 +26,9 @@ tags:
     ```
     **That's it!** No configuration required.
 
-!!! success "🎉 What's New: v6.1.0 - Quarto Lint Validation"
-    Catch structural mistakes before production. 4 validation rules for teaching materials.
-    [→ See what's new](RELEASES.md#v610-quarto-lint-validation-2026-02-01){ .md-button }
+!!! success "🎉 What's New: v6.2.0 - Docs Overhaul + Website Reorganization"
+    Reduced navigation from 14 to 7 sections. Landing pages with grid cards. Tags for cross-cutting discovery.
+    [→ See what's new](RELEASES.md){ .md-button }
     [→ All releases](RELEASES.md){ .md-button }
 
 ---
@@ -144,7 +144,7 @@ Choose your path based on what you need right now:
 
 <div class="grid cards" markdown>
 
--   :rocket: { .lg .middle }
+-   :rocket:{ .lg .middle }
     **5-Minute Quick Start**
 
     ---
@@ -153,7 +153,7 @@ Choose your path based on what you need right now:
 
     [→ Quick Start](getting-started/quick-start.md)
 
--   :books: { .lg .middle }
+-   :books:{ .lg .middle }
     **Step-by-Step Tutorials**
 
     ---
@@ -162,7 +162,7 @@ Choose your path based on what you need right now:
 
     [→ Tutorial 01](tutorials/01-first-session.md)
 
--   :fire: { .lg .middle }
+-   :fire:{ .lg .middle }
     **Dopamine Features**
 
     ---
@@ -171,7 +171,7 @@ Choose your path based on what you need right now:
 
     [→ Dopamine Guide](tutorials/06-dopamine-features.md)
 
--   :compass: { .lg .middle }
+-   :compass:{ .lg .middle }
     **Command Reference**
 
     ---
@@ -180,7 +180,7 @@ Choose your path based on what you need right now:
 
     [→ Reference](help/QUICK-REFERENCE.md)
 
--   :teacher: { .lg .middle }
+-   :teacher:{ .lg .middle }
     **Teaching Workflow**
 
     ---
@@ -189,7 +189,7 @@ Choose your path based on what you need right now:
 
     [→ Teaching Guide](guides/TEACHING-SYSTEM-ARCHITECTURE.md)
 
--   :mag: { .lg .middle }
+-   :mag:{ .lg .middle }
     **Common Workflows**
 
     ---
@@ -266,4 +266,4 @@ catch "idea"      # Quick capture
 
 ---
 
-**v6.1.0** · Pure ZSH · Zero Dependencies · MIT License
+**v6.2.0** · Pure ZSH · Zero Dependencies · MIT License

docs/reference/index.md

@@ -55,7 +55,7 @@ tags:
 ### API & Architecture
 
 | Page | Description |
-|------|-------------|
+| ---- | ----------- |
 | [Master API Reference](MASTER-API-REFERENCE.md) | Function signatures and usage for all libraries |
 | [Master Dispatcher Guide](MASTER-DISPATCHER-GUIDE.md) | All 12 dispatchers documented |
 | [Master Architecture](MASTER-ARCHITECTURE.md) | System architecture with Mermaid diagrams |
@@ -64,7 +64,7 @@ tags:
 ### Commands
 
 | Page | Description |
-|------|-------------|
+| ---- | ----------- |
 | [flow](../commands/flow.md) | Main entry point |
 | [work](../commands/work.md) | Session management |
 | [finish](../commands/finish.md) | End session |
@@ -77,15 +77,15 @@ tags:
 ### Quick Reference Cards
 
 | Page | Description |
-|------|-------------|
+| ---- | ----------- |
 | [Token & Secrets](REFCARD-TOKEN-SECRETS.md) | Token management cheat sheet |
 | [Chezmoi Safety](REFCARD-DOT-SAFETY.md) | Dotfile safety quick reference |
 | [Chezmoi Safety API](API-DOT-SAFETY.md) | Safety feature API reference |
 
 ### Architecture Deep Dives
 
 | Page | Description |
-|------|-------------|
+| ---- | ----------- |
 | [Chezmoi Safety](../architecture/DOT-SAFETY-ARCHITECTURE.md) | Preview-before-add architecture |
 | [Doctor Token System](../architecture/DOCTOR-TOKEN-ARCHITECTURE.md) | Token automation internals |
 | [Teaching Dates](../architecture/TEACHING-DATES-ARCHITECTURE.md) | Date management system |

docs/teaching/index.md

@@ -225,4 +225,4 @@ teach plan help
 ---
 
 **Last Updated:** 2026-01-31
-**Version:** v6.0.0
+**Version:** v6.2.0