toc.yml

- name: Azure Boards Documentation
  href: index.yml
- name: "What is Azure Boards?"
  href: get-started/what-is-azure-boards.md
  displayName: scrum, kanban, basics, agile, CMMI, backlog
- name: "Why use Azure Boards?"
  href: get-started/why-use-azure-boards.md
  displayName: scale, collaborate, visual, monitor, status, progress, dashboards, office integration, extensions, mobile, free
- name: Best practices for Agile project management
  href: best-practices-agile-project-management.md
  displayName: agile, kanban, scrum, rollup, filtering, waterfall, deliverables, cadence, sprint cadence, work types, CMMI, product plan, product backlog
- name: Quick reference
  href: ./work-items/quick-ref.md
  displayName: agile, charts, interitance, work item, scrum, state categories, bulk modify, WIT
- name: Get started
  href: get-started/toc.yml
- name: Basic concepts 
  items:
  - name: "Backlogs, boards, & plans"
    href: backlogs/backlogs-boards-plans.md
    displayname: In Progress, Rollup, Taskboard
  - name: Best tool for the job
    href: work-items/best-tool-add-update-link-work-items.md
    displayName: backlogs, boards, office integration, marketplace extensions, work items
  - name: Agile glossary
    href: ./work-items/agile-glossary.md
    displayName: agile, field, favorites, follow, inheritance, process model, issue, Kanban, link, pick list, plans, queries, remote linking, sprints, taskboard, teams, widgets  
  - name: Choose a process
    href: work-items/guidance/choose-process.md
    displayname: agile, basic, scrum, cmmi, test
  - name: About work items
    href: work-items/about-work-items.md
    displayname: user stories, issues, bugs, features, epics, backlog items, requirements, assign, web portal, cient
  - name: "Area & iteration paths"
    href: ../organizations/settings/about-areas-iterations.md?bc=%252fazure%252fdevops%252fboards%252fbreadcrumb%252ftoc.json&toc=%252fazure%252fdevops%252fboards%252ftoc.json
    displayName: classification nodes, iteration paths, reserved names, special characters
  - name: Workflow states & categories
    href: ./work-items/workflow-and-state-categories.md
    displayName: auto complete, pull requests
  - name: Linking & traceability
    href: ./queries/link-work-items-support-traceability.md
    displayName: parent, child, git, remote  
  - name: Link types 
    href: ./queries/link-type-reference.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json toc.json  
    displayName: work, hyperlink, external, github, remote    
  - name: Work tracking limits
    href: ../organizations/settings/work/object-limits.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json 
    displayName: customize, migrate, import
  - name: Process guidance
    href: work-items/guidance/toc.yml
  - name: Permissions & access
    items:
    - name: Quick guide to default permissions & access
      href: ./get-started/permissions-access-boards.md
      displayname: security, features, stakeholder access
    - name: Default permissions & access (Security)
      href: ../organizations/security/permissions-access-work-tracking.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json 
      displayName: team administrator, administrator, access
    - name: Set work tracking & plan permissions 
      href: ../organizations/security/set-permissions-access-work-tracking.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json 
      displayName: work item tags, roles, object-level, project-level, permissions
    - name: Grant or restrict permissions to select tasks
      href: ../organizations/security/restrict-access.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json 
      displayName: restrict access, visibility, closed work
- name: Configure & customize 
  items:
  - name: Configure & customize guidance 
    href: configure-customize.md
    displayname: Scrum, Kanban, Scrumban, portfolio, hierarchy, rollup, calendar, time
  - name: Define area paths & assign to a team 
    href: ../organizations/settings/set-area-paths.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json 
    displayName: levels, rollup, area paths
  - name: Define iteration (sprints) & configure team iterations 
    href: ../organizations/settings/set-iteration-paths-sprints.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json 
    displayName: forecast, team sprints
  - name: Set up your backlogs & boards
    href: backlogs/set-up-your-backlog.md 
    displayname: default, correct, Kanban, custom
  - name: Change column options
    href: backlogs/set-column-options.md
    displayName: sort, persistence
  - name: Filter backlogs, boards, queries, and plans
    href: backlogs/filter-backlogs-boards-plans.md  
  - name: Add & manage teams
    items:
    - name: "About teams & Agile tools"
      href: ../organizations/settings/about-teams-and-settings.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json 
      displayName: default team, default area path, iteration path, sprint backlogs, working days, product backlog, task boards, team groups
    - name: Add a team
      href: ../organizations/settings/add-teams.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json 
    - name: Add a team administrator
      href: ../organizations/settings/add-team-administrator.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json 
      displayName: edit administrator, administrator, permissions
    - name: Add users to a project or team 
      href: ../organizations/security/add-users-team-project.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json 
      displayName: add users, users to project, users to team, team
    - name: Configure team tools
      href: ../organizations/settings/manage-teams.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json 
      displayName: team dashboard, backlog, team name, notifications
  - name: Set the Work Items experience (Visual Studio)
    href: work-items/set-work-item-experience-vs.md
  - name: Manage process templates
    href: work-items/guidance/manage-process-templates.md
    displayName: templates
  - name: Project portal & process guidance
    items:
    - name: Configure or add a project portal
      href: ../project/configure-or-add-a-project-portal.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json  
    - name: Configure or redirect process guidance
      href: ../project/configure-or-redirect-process-guidance.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json  
- name: Azure Boards & GitHub
  href: github/toc.yml
- name: Work items
  href: work-items/toc.yml 
- name: Boards & Kanban
  href: boards/toc.yml 
- name: Backlogs
  href: backlogs/toc.yml 
- name: Sprints & Scrum
  href: sprints/toc.yml 
- name: Queries & search 
  href: queries/toc.yml 
- name: Plans & portfolios
  href: plans/toc.yml
- name: Track work, code, builds, and releases
  items:
  - name: End-to-end traceability
    href: ../cross-service/end-to-end-traceability.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
    displayname: pull requests, commits, comments, build 
  - name: "Use #ID to link to work items"
    href: ../notifications/add-links-to-work-items.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
    displayname: pull requests, commits, comments, build, wiki
  - name: Configure Git repositories to integrate with work tracking 
    href: ../repos/git/configure-repos-work-tracking.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
    displayname: auto link, transition, check for linked work items, auto complete, external links 
  - name: Configure pipelines to support work tracking
    href: ../pipelines/integrations/configure-pipelines-work-tracking.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
    displayname: auto link, create work item on build failure, report deployment status,  
  - name: Drive Git development
    displayName: create branch, new branch, build 
    href: backlogs/connect-work-items-to-git-dev-ops.md
  - name: View deployment stages on work item form
    href: work-items/work-item-deployments-control.md
    displayname: release
  - name: Auto complete work items with pull requests
    href: work-items/auto-complete-work-items-pull-requests.md  
  - name: Request and track feedback
    href: ../project/feedback/toc.yml 
- name: Excel, Project, PowerPoint 
  items:
  - name: Connect to an Office client
    href: backlogs/office/track-work.md
    displayName: Excel, Microsoft Excel, open in Excel, Office 365
  - name: Bulk add or modify work items (Excel)
    href: backlogs/office/bulk-add-modify-work-items-excel.md
    displayName: bulk edit, Excel, edit in Excel
  - name: Excel FAQs
    href: backlogs/office/faqs.yml
    displayName: edit in Excel, open in Excel
  - name: Project & Storyboarding (Deprecated)  
    items:
    - name: Create backlog items & tasks (Project) 
      href: /previous-versions/azure/devops/boards/backlogs/office/create-your-backlog-tasks-using-project
    - name: Schedule projects (Project) 
      href: /previous-versions/azure/devops/boards/backlogs/office/schedule-projects-using-microsoft-project
    - name: Rollup work using Project
      href: /previous-versions/azure/devops/boards/backlogs/office/rollup-estimated-and-actual-work-using-project
    - name: Storyboard your ideas (PowerPoint)
      href: /previous-versions/azure/devops/boards/backlogs/office/storyboard-your-ideas-using-powerpoint
    - name: Add & share storyboard shapes (PowerPoint)
      href: /previous-versions/azure/devops/boards/backlogs/office/add-share-storyboard-shapes
  - name: Troubleshooting
    items:
    - name: Office integration issues
      href: backlogs/office/tfs-office-integration-issues.md
    - name: Resolve Excel data conflicts
      href: backlogs/office/resolve-excel-data-conflicts-publish-refresh.md
      displayName: conflicts, Excel, conflicting work-items/guidance/cmmi/guidance-review-meeting-field-reference-cmmi.md
    - name: Resolve Excel data validation errors
      href: backlogs/office/resolve-excel-data-validation-errors.md
      displayName: error checking in Excel, error checking, invalid links
    - name: Resolve invalid links in an Excel tree list
      href: backlogs/office/resolve-excel-invalid-links-tree-list.md
      displayName: duplicate titles, disconnected, sorted tree, locked
- name: Integrations & extensions
  href: extensions/toc.yml
- name: Troubleshooting
  items:
  - name: FAQs 
    href: faqs.yml 
  - name: Set up your backlogs & boards
    href: backlogs/set-up-your-backlog.md 
  - name: Fix "Ordering backlog items is disabled"
    href: backlogs/resolve-backlog-reorder-issues.md
    displayname: reorder, disable, nest, natural hierarchy, in progress  
  - name: Work item form caching
    href: ../organizations/settings/work/troubleshoot-work-item-form-caching-issues.md  
    displayname: IndexDB, rule
- name: Field reference
  items:
  - name: Work item field index
    href: work-items/guidance/work-item-field.md
  - name: Work item fields
    href: work-items/work-item-fields.md
    displayname: attribute, Work Item Field Explorer
  - name: "Code review & feedback fields"
    href: work-items/guidance/guidance-code-review-feedback-field-reference.md
  - name: "Bugs, issues, & risks fields"
    href: work-items/guidance/cmmi/guidance-bugs-issues-risks-field-reference-cmmi.md
  - name: Change request fields
    href: work-items/guidance/cmmi/guidance-change-request-field-reference-cmmi.md
  - name: Requirements fields
    href: work-items/guidance/cmmi/guidance-requirements-field-reference-cmmi.md
  - name: Review meeting fields
    href: work-items/guidance/cmmi/guidance-review-meeting-field-reference-cmmi.md
- name: REST API Reference
  items:
  - name: Work Items
    href: /rest/api/vsts/wit/work%20items
  - name: Fields
    href: /rest/api/azure/devops/wit/fields
  - name: Boards
    href: /rest/api/vsts/work/boards
  - name: Backlogs
    href: /rest/api/azure/devops/work/backlogs
  - name: Queries
    href: /rest/api/azure/devops/wit/queries
  - name: Plans
    href: /rest/api/azure/devops/work/plans
  - name: Work Item Query Language 
    href: /rest/api/vsts/wit/wiql 
- name: DevOps Resource Center
  items:
  - name: What is Agile?
    href: /devops/plan/what-is-agile
  - name: What is Agile development?
    href: /devops/plan/what-is-agile-development
    displayName: backlog, always be agile, CI, CD
  - name: Creating productive teams
    href: /devops/plan/building-productive-teams
    displayName: crew, crews, crew size, crew rotation
  - name: What is Scrum?
    href: /devops/plan/what-is-scrum
    displayName: scrum lifecycle, sprint planning, task board
- name: Resources
  items:
  - name: Dashboards, Charts, Reports, & Widgets
    href: ../report/dashboards/dashboards.md 
  - name: Process customization 
    href: ../reference/index.yml
  - name: Azure Test Plans 
    href: ../test/index.yml
  - name: Client support 
    href: ../user-guide/tools.md
  - name: Azure DevOps CLI
    href: /cli/azure/boards