Optimize Getting Started learning experience

[cdcavell]

Summary

Optimizes the docs/getting-started experience to make ASI Backbone Learning easier to navigate, scan, and evaluate without changing the underlying architectural guidance.

This update restructures the primary Getting Started pages around clearer entry points, shorter decision paths, and more consistent learning patterns while preserving the existing DocFX-compatible Markdown structure and destination links.

Changes

• Optimized docs/getting-started/index.md

  • Added a clearer Start Here experience.
  • Condensed the architecture overview.
  • Made the five-part foundation easier to scan.
  • Simplified the Tutorial → Sample → Tests → Lab progression.
  • Reduced duplicate explanatory material.
  • Preserved the core governed-execution boundaries and existing navigation links.

• Optimized docs/getting-started/adoption-personas-and-entry-points.md

  • Added a role/responsibility entry table.
  • Standardized persona sections around:
    • Typical question
    • Start with
    • Evaluate for
  • Added shared evaluation questions across roles.
  • Clarified that personas are navigation aids rather than strict job classifications.

• Optimized docs/getting-started/find-your-path.md

  • Added a compact problem-oriented path selector.
  • Standardized each route around:
    • Start
    • Supporting material
    • Run and modify
    • Stop here when
    • Go deeper when
  • Reinforced the principle of using the smallest architecture that preserves the required boundaries.

• Optimized docs/getting-started/learning-model.md

  • Added a concise learning-model overview table.
  • Clarified the progression from problem to tutorial, sample, tests, lab, comparison, and working implementation.
  • Simplified the distinction between canonical and alternative patterns.
  • Improved the explanation of framework independence and layered learning.

• Optimized docs/getting-started/learning-path-map.md

  • Added a route-selection summary before the Mermaid diagram.
  • Simplified the explanation of recommended versus optional sequencing.
  • Converted the textual foundation into a scannable table.
  • Preserved the existing interactive Mermaid navigation and advanced-path links.

Design Goals

• Improve first-time reader orientation.
• Reduce cognitive load and repeated prose.
• Preserve the existing problem-first learning philosophy.
• Keep framework adoption optional.
• Make tutorials, samples, tests, and labs easier to understand as complementary learning tools.
• Maintain the distinction between recommended learning sequences and hard prerequisites.
• Preserve current DocFX styling and navigation behavior.

Fix

• Updated the Find Your Path link to reference the renamed Five-Part Foundation heading in getting-started/index.md.
• Resolves the DocFX InvalidBookmark warning that was treated as an error by the documentation build.

Validation

• All generated patches passed git apply --check.
• git diff --check passed for each change.
• Existing Markdown destination links were preserved.
• Existing Mermaid click targets on the Learning Path Map were preserved.
• No files outside docs/getting-started were modified.