# Learning Tracks
# Each track is a curated journey through Bengal documentation.
# Keys must match track_id in the corresponding content/tracks/*.md page.

zero-to-deployed:
  title: "Zero to Deployed"
  description: "Build and deploy your first Bengal site in under an hour."
  duration: "45 min"
  audience: "Complete beginners"
  items:
    - docs/get-started/installation
    - docs/get-started/quickstart-writer
    - docs/get-started/scaffold-your-site
    - docs/tutorials/sites/build-a-blog
    - docs/building/deployment/_index
    - docs/tutorials/operations/automate-with-github-actions

content-mastery:
  title: "Content Author Mastery"
  description: "Master advanced Markdown features, directives, and content reuse."
  duration: "60 min"
  audience: "Writers who completed quickstart"
  items:
    - docs/content/authoring/_index
    - docs/content/authoring/linking
    - docs/content/authoring/code-blocks
    - docs/content/authoring/tables
    - docs/reference/directives/_index
    - docs/reference/directives/admonitions
    - docs/reference/directives/layout
    - docs/reference/directives/interactive
    - docs/content/reuse/_index
    - docs/content/reuse/snippets

theme-developer:
  title: "Theme Developer Journey"
  description: "From CSS tweaks to building complete custom themes."
  duration: "90 min"
  audience: "Designers and frontend developers"
  items:
    - docs/get-started/quickstart-themer
    - docs/theming/themes/customize
    - docs/tutorials/theming/swizzle-default-theme
    - docs/theming/assets/_index
    - docs/theming/recipes/_index
    - docs/theming/recipes/reading-time
    - docs/theming/recipes/list-recent-posts
    - docs/theming/templating/_index
    - docs/theming/templating/functions
    - docs/reference/theme-variables

team-lead:
  title: "Documentation Team Lead"
  description: "Set up scalable documentation workflows with validation and CI/CD."
  duration: "75 min"
  audience: "Tech writers, doc managers, lead engineers"
  items:
    - docs/content/collections/_index
    - docs/content/sources/_index
    - docs/content/validation/_index
    - docs/content/validation/validate-and-fix
    - docs/content/analysis/_index
    - docs/building/configuration/_index
    - docs/building/deployment/_index
    - docs/tutorials/operations/automate-with-github-actions

migration-express:
  title: "Migration Express"
  description: "Migrate your existing static site to Bengal while preserving URLs."
  duration: "60 min"
  audience: "Hugo, Sphinx, Docusaurus users"
  items:
    - docs/about/comparison
    - docs/tutorials/migration/_index
    - docs/tutorials/migration/from-hugo
    - docs/tutorials/migration/from-sphinx
    - docs/tutorials/migration/from-docusaurus
    - docs/content/organization/_index
    - docs/content/organization/frontmatter
    - docs/building/configuration/_index

api-docs-specialist:
  title: "API Documentation Specialist"
  description: "Auto-generate API documentation from source code and specs."
  duration: "60 min"
  audience: "Developer advocates, API teams, SDK maintainers"
  items:
    - docs/content/sources/_index
    - docs/content/sources/autodoc
    - docs/extending/custom-sources
    - docs/content/collections/_index
    - docs/content/validation/_index
    - docs/building/deployment/_index

versioning-expert:
  title: "Versioning Expert"
  description: "Maintain multiple versions of documentation for different releases."
  duration: "45 min"
  audience: "Library authors, API teams, enterprise docs"
  items:
    - docs/content/versioning/_index
    - docs/content/versioning/folder-mode
    - docs/content/versioning/git-mode
    - docs/content/versioning/cross-version-links
    - docs/content/versioning/directives

performance-optimizer:
  title: "Performance Optimizer"
  description: "Build and maintain large documentation sites efficiently."
  duration: "30 min"
  audience: "DevOps, large doc teams, enterprise"
  items:
    - docs/building/performance/_index
    - docs/building/performance/large-sites
    - docs/content/analysis/_index
    - docs/content/analysis/graph
    - docs/about/benchmarks

extension-developer:
  title: "Extension Developer"
  description: "Create custom directives, content sources, and build integrations."
  duration: "90 min"
  audience: "Python developers, plugin authors"
  items:
    - docs/extending/_index
    - docs/extending/build-hooks
    - docs/extending/custom-directives
    - docs/extending/custom-sources
    - docs/extending/collections
    - docs/extending/theme-customization
