Skip to content

Commit 522070a

Browse files
authored
Removing unneeded breadcrumb files, adding missing articles from toc (#5260)
* Removing unneeded breadcrumb files, adding missing articles from toc * removing &bc=/azure/devops/.. references as they aren't valid and not needed. * fix build error * build error fix * consolidate marketplace, extend, integrate, service-hooks tocs into one marketplace-extensibility toc to fix orphan articles. * syntax build error fix * build fix 2 * build fix 3 * removing unneeded toc.yml files as they have been consolidated into marketplace-extensibility/toc.yml file * updates to report index file; removed extend articles from report index file. * finishing up 1 * experiment - adding dual entries in breadcrumb file * Finishing up 2 * introducing back in marketplace-extensibility breadcrumbs * reverting some changes
1 parent e8a148d commit 522070a

File tree

57 files changed

+678
-2411
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

57 files changed

+678
-2411
lines changed

docs/artifacts/breadcrumb/toc.yml

-12
This file was deleted.

docs/boards/backlogs/toc.yml

+2-2
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@
4242
href: best-practices-product-backlog.md
4343
displayname: product owner, role, acceptance criteria, spikes
4444
- name: Rollup of work & other fields
45-
href: ../../reference/xml/support-rollup-of-work-and-other-fields.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
45+
href: ../../reference/xml/support-rollup-of-work-and-other-fields.md?toc=/azure/devops/boards/toc.json
4646
displayname: native, Planning pane, tools, query charts, Excel
4747
- name: View/configure velocity
48-
href: ../../report/dashboards/team-velocity.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
48+
href: ../../report/dashboards/team-velocity.md?toc=/azure/devops/boards/toc.json

docs/boards/boards/toc.yml

+2-2
Original file line numberDiff line numberDiff line change
@@ -48,6 +48,6 @@
4848
- name: Kanban concepts
4949
href: kanban-key-concepts.md
5050
- name: View/configure CFD
51-
href: ../../report/dashboards/cumulative-flow.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
51+
href: ../../report/dashboards/cumulative-flow.md?toc=/azure/devops/boards/toc.json
5252
- name: Configure Lead/Cycle time widget
53-
href: ../../report/dashboards/cycle-time-and-lead-time.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
53+
href: ../../report/dashboards/cycle-time-and-lead-time.md?toc=/azure/devops/boards/toc.json

docs/boards/breadcrumb/toc.yml

-13
This file was deleted.

docs/boards/faqs.yml

+2-2
Original file line numberDiff line numberDiff line change
@@ -46,8 +46,8 @@ sections:
4646
- question: How can I restrict viewing or modifying select work items?
4747
answer: |
4848
You can restrict access by setting permissions for an area path. To learn more, see the following articles:
49-
- [Set work tracking and plan permissions](../organizations/security/set-permissions-access-work-tracking.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json)
50-
- [Grant or restrict permissions to select tasks](../organizations/security/restrict-access.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json)
49+
- [Set work tracking and plan permissions](../organizations/security/set-permissions-access-work-tracking.md?toc=/azure/devops/boards/toc.json)
50+
- [Grant or restrict permissions to select tasks](../organizations/security/restrict-access.md?toc=/azure/devops/boards/toc.json)
5151
5252
- question: Can caching impact rules applied to work items?
5353
answer: |

docs/boards/get-started/toc.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,6 @@
1616
href: manage-boards.md
1717
- name: System fields
1818
displayName: modify fields, remaining work, state, iteration ID, node, remote link count, effort
19-
href: ../work-items/guidance/basic-field-reference.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
19+
href: ../work-items/guidance/basic-field-reference.md?toc=/azure/devops/boards/toc.json
2020
- name: Keyboard shortcuts
2121
href: keyboard-shortcuts.md

docs/boards/queries/toc.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@
1515
href: organize-queries.md
1616
displayname: delete, rename, dashboard, share, save
1717
- name: Chart a query
18-
href: ../../report/dashboards/charts.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
18+
href: ../../report/dashboards/charts.md?toc=/azure/devops/boards/toc.json
1919
- name: Triage work items
2020
href: triage-work-items.md
2121
- name: Filter your queries

docs/boards/sprints/toc.yml

+2-2
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@
4848
href: scrum-key-concepts.md
4949
displayname: capacity bars, scrum, scrum master, product owner, technical debt, triage, velocity
5050
- name: View/configure sprint burndown
51-
href: ../../report/dashboards/configure-sprint-burndown.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
51+
href: ../../report/dashboards/configure-sprint-burndown.md?toc=/azure/devops/boards/toc.json
5252
displayname: charts, in-context charts, in context
5353
- name: Configure a Burndown or Burnup widget
54-
href: ../../report/dashboards/configure-burndown-burnup-widgets.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
54+
href: ../../report/dashboards/configure-burndown-burnup-widgets.md?toc=/azure/devops/boards/toc.json

docs/boards/toc.yml

+18-18
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@
3333
displayname: user stories, issues, bugs, features, epics, backlog items, requirements, assign, web portal, cient
3434
- name: Area & iteration paths
3535
displayName: classification nodes, iteration paths, reserved names, special characters
36-
href: ../organizations/settings/about-areas-iterations.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
36+
href: ../organizations/settings/about-areas-iterations.md?toc=/azure/devops/boards/toc.json
3737
- name: Workflow states & categories
3838
displayName: auto complete, pull requests
3939
href: ./work-items/workflow-and-state-categories.md
@@ -42,10 +42,10 @@
4242
href: ./queries/link-work-items-support-traceability.md
4343
- name: Link types
4444
displayName: work, hyperlink, external, github, remote
45-
href: ./queries/link-type-reference.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
45+
href: ./queries/link-type-reference.md?toc=/azure/devops/boards/toc.json
4646
- name: Work tracking limits
4747
displayName: customize, migrate, import
48-
href: ../organizations/settings/work/object-limits.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
48+
href: ../organizations/settings/work/object-limits.md?toc=/azure/devops/boards/toc.json
4949
- name: Process guidance
5050
href: work-items/guidance/toc.yml
5151
- name: Permissions & access
@@ -55,24 +55,24 @@
5555
displayname: security, features, stakeholder access
5656
- name: Default permissions & access (Security)
5757
displayName: team administrator, administrator, access
58-
href: ../organizations/security/permissions-access-work-tracking.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
58+
href: ../organizations/security/permissions-access-work-tracking.md?toc=/azure/devops/boards/toc.json
5959
- name: Set work tracking & plan permissions
6060
displayName: work item tags, roles, object-level, project-level, permissions
61-
href: ../organizations/security/set-permissions-access-work-tracking.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
61+
href: ../organizations/security/set-permissions-access-work-tracking.md?toc=/azure/devops/boards/toc.json
6262
- name: Grant or restrict permissions to select tasks
6363
displayName: restrict access, visibility, closed work
64-
href: ../organizations/security/restrict-access.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
64+
href: ../organizations/security/restrict-access.md?toc=/azure/devops/boards/toc.json
6565
- name: Configure & customize
6666
items:
6767
- name: Configure & customize guidance
6868
href: configure-customize.md
6969
displayname: Scrum, Kanban, Scrumban, portfolio, hierarchy, rollup, calendar, time
7070
- name: Define area paths & assign to a team
7171
displayName: levels, rollup, area paths
72-
href: ../organizations/settings/set-area-paths.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
72+
href: ../organizations/settings/set-area-paths.md?toc=/azure/devops/boards/toc.json
7373
- name: Define iteration (sprints) & configure team iterations
7474
displayName: forecast, team sprints
75-
href: ../organizations/settings/set-iteration-paths-sprints.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
75+
href: ../organizations/settings/set-iteration-paths-sprints.md?toc=/azure/devops/boards/toc.json
7676
- name: Set up your backlogs & boards
7777
href: backlogs/set-up-your-backlog.md
7878
displayname: default, correct, Kanban, custom
@@ -87,18 +87,18 @@
8787
items:
8888
- name: About teams & Agile tools
8989
displayName: default team, default area path, iteration path, sprint backlogs, working days, product backlog, task boards, team groups
90-
href: ../organizations/settings/about-teams-and-settings.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
90+
href: ../organizations/settings/about-teams-and-settings.md?toc=/azure/devops/boards/toc.json
9191
- name: Add a team
92-
href: ../organizations/settings/add-teams.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
92+
href: ../organizations/settings/add-teams.md?toc=/azure/devops/boards/toc.json
9393
- name: Add a team administrator
9494
displayName: edit administrator, administrator, permissions
95-
href: ../organizations/settings/add-team-administrator.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
95+
href: ../organizations/settings/add-team-administrator.md?toc=/azure/devops/boards/toc.json
9696
- name: Add users to a project or team
9797
displayName: add users, users to project, users to team, team
98-
href: ../organizations/security/add-users-team-project.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
98+
href: ../organizations/security/add-users-team-project.md?toc=/azure/devops/boards/toc.json
9999
- name: Configure team tools
100100
displayName: team dashboard, backlog, team name, notifications
101-
href: ../organizations/settings/manage-teams.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
101+
href: ../organizations/settings/manage-teams.md?toc=/azure/devops/boards/toc.json
102102
- name: Set the Work Items experience (Visual Studio)
103103
href: work-items/set-work-item-experience-vs.md
104104
- name: Manage process templates
@@ -123,16 +123,16 @@
123123
- name: Track work, code, builds, and releases
124124
items:
125125
- name: End-to-end traceability
126-
href: ../cross-service/end-to-end-traceability.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
126+
href: ../cross-service/end-to-end-traceability.md?toc=/azure/devops/boards/toc.json
127127
displayname: pull requests, commits, comments, build
128128
- name: 'Use #ID to link to work items'
129-
href: ../organizations/notifications/add-links-to-work-items.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
129+
href: ../organizations/notifications/add-links-to-work-items.md?toc=/azure/devops/boards/toc.json
130130
displayname: pull requests, commits, comments, build, wiki
131131
- name: Configure Git repositories to integrate with work tracking
132-
href: ../repos/git/configure-repos-work-tracking.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
132+
href: ../repos/git/configure-repos-work-tracking.md?toc=/azure/devops/boards/toc.json
133133
displayname: auto link, transition, check for linked work items, auto complete, external links
134134
- name: Configure pipelines to support work tracking
135-
href: ../pipelines/integrations/configure-pipelines-work-tracking.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
135+
href: ../pipelines/integrations/configure-pipelines-work-tracking.md?toc=/azure/devops/boards/toc.json
136136
displayname: auto link, create work item on build failure, report deployment status,
137137
- name: Drive Git development
138138
displayName: create branch, new branch, build
@@ -183,7 +183,7 @@
183183
- name: Project portal & process guidance (Deprecated)
184184
items:
185185
- name: Configure or add a project portal
186-
href: ../project/configure-or-add-a-project-portal.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
186+
href: ../project/configure-or-add-a-project-portal.md?toc=/azure/devops/boards/toc.json
187187
- name: Configure or redirect process guidance
188188
href: /previous-versions/azure/devops/project/configure-or-redirect-process-guidance?view=tfs-2017&preserve-view=true
189189
- name: Integrations & extensions

docs/boards/work-items/toc.yml

+2-2
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@
3434
href: follow-work-items.md
3535
displayname: query
3636
- name: Use @mentions in discussions
37-
href: ../../organizations/notifications/at-mentions.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
37+
href: ../../organizations/notifications/at-mentions.md?toc=/azure/devops/boards/toc.json
3838
displayname: people picker
3939
- name: Add tags to work items
4040
href: ../queries/add-tags-to-work-items.md
@@ -78,4 +78,4 @@
7878
- name: Define a work item URL
7979
href: work-item-url-hyperlink.md
8080
- name: Go mobile
81-
href: ../../project/navigation/mobile-work.md?toc=/azure/devops/boards/toc.json&bc=/azure/devops/boards/breadcrumb/toc.json
81+
href: ../../project/navigation/mobile-work.md?toc=/azure/devops/boards/toc.json

docs/breadcrumb/toc.yml

+61-61
Original file line numberDiff line numberDiff line change
@@ -12,16 +12,6 @@
1212
- name: Azure Boards
1313
tocHref: /azure/devops/boards/
1414
topicHref: /azure/devops/boards/index
15-
- name: Get started
16-
tocHref: /azure/devops/get-started/
17-
topicHref: /azure/devops/get-started/index
18-
items:
19-
- name: Start using Azure DevOps
20-
tocHref: /azure/devops/user-guide/
21-
topicHref: /azure/devops/user-guide/what-is-azure-devops
22-
- name: Migrate & import
23-
tocHref: /azure/devops/migrate/
24-
topicHref: /azure/devops/migrate/migration-overview
2515
- name: Azure Pipelines
2616
tocHref: /azure/devops/pipelines/
2717
topicHref: /azure/devops/pipelines/index
@@ -34,6 +24,33 @@
3424
- name: Analytics & Reporting
3525
tocHref: /azure/devops/report/
3626
topicHref: /azure/devops/report/index
27+
- name: Get started
28+
tocHref: /azure/devops/get-started/
29+
topicHref: /azure/devops/get-started/index
30+
items:
31+
- name: Start using Azure DevOps
32+
tocHref: /azure/devops/user-guide/
33+
topicHref: /azure/devops/user-guide/what-is-azure-devops
34+
- name: Migrate & import
35+
tocHref: /azure/devops/migrate/
36+
topicHref: /azure/devops/migrate/migration-overview
37+
- name: Cross-service, Azure, & GitHub Integration
38+
tocHref: /azure/devops/cross-service/
39+
topicHref: /azure/devops/cross-service/index
40+
items:
41+
- name: Work across projects
42+
tocHref: /azure/devops/project/
43+
topicHref: /azure/devops/project/work-across-projects-faqs
44+
- name: Developer Resources
45+
tocHref: /azure/devops/dev-resources/
46+
topicHref: /azure/devops/dev-resources/index
47+
items:
48+
- name: Azure DevOps CLI
49+
tocHref: /azure/devops/cli/
50+
topicHref: /azure/devops/cli/index
51+
- name: Demo Generator
52+
tocHref: /azure/devops/demo-gen/
53+
topicHref: /azure/devops/demo-gen/index
3754
- name: Settings & Usage
3855
tocHref: /azure/devops/organizations/
3956
topicHref: /azure/devops/organizations/index
@@ -60,48 +77,6 @@
6077
- name: Billing
6178
tocHref: /azure/devops/organizations/billing/
6279
topicHref: /azure/devops/organizations/billing/overview
63-
- name: Azure Boards customization
64-
tocHref: /azure/devops/reference/
65-
topicHref: /azure/devops/reference/index
66-
items:
67-
- name: Inherited process
68-
tocHref: /azure/devops/organizations/settings/work/
69-
topicHref: /azure/devops/organizations/settings/work/inheritance-process-model
70-
- name: On-premises XML process
71-
tocHref: /azure/devops/reference/xml/
72-
topicHref: /azure/devops/reference/on-premises-xml-process-model
73-
- name: Hosted XML process
74-
tocHref: /azure/devops/organizations/settings/work/hosted/
75-
topicHref: /azure/devops/organizations/settings/work/hosted-xml-process-model
76-
- name: Process templates
77-
tocHref: /azure/devops/reference/process-templates/
78-
topicHref: /azure/devops/reference/process-templates/customize-process
79-
- name: witadmin command line
80-
tocHref: /azure/devops/reference/witadmin/
81-
topicHref: /azure/devops/reference/witadmin/witadmin-customize-and-manage-objects-for-tracking-work
82-
- name: Marketplace & extensibility
83-
tocHref: /azure/devops/marketplace-extensibility/
84-
topicHref: /azure/devops/marketplace-extensibility/
85-
items:
86-
- name: Install extensions
87-
tocHref: /azure/devops/marketplace/
88-
topicHref: /azure/devops/marketplace/overview
89-
- name: Develop extensions
90-
tocHref: /azure/devops/extend/
91-
topicHref: /azure/devops/extend/overview
92-
- name: Integrate applications
93-
tocHref: /azure/devops/integrate/
94-
topicHref: /azure/devops/integrate/index
95-
- name: Service hooks
96-
tocHref: /azure/devops/service-hooks/
97-
topicHref: /azure/devops/service-hooks/overview
98-
- name: Cross-service, Azure, & GitHub Integration
99-
tocHref: /azure/devops/cross-service/
100-
topicHref: /azure/devops/cross-service/index
101-
items:
102-
- name: Work across projects
103-
tocHref: /azure/devops/project/
104-
topicHref: /azure/devops/project/work-across-projects-faqs
10580
- name: Wikis, Search, & Navigation
10681
tocHref: /azure/devops/project/
10782
topicHref: /azure/devops/project/index
@@ -118,13 +93,38 @@
11893
- name: Feedback
11994
tocHref: /azure/devops/project/feedback/
12095
topicHref: /azure/devops/project/feedback/index
121-
- name: Developer Resources
122-
tocHref: /azure/devops/dev-resources/
123-
topicHref: /azure/devops/dev-resources/index
96+
- name: Marketplace & Extensibility
97+
tocHref: /azure/devops/marketplace-extensibility/
98+
topicHref: /azure/devops/marketplace-extensibility/
12499
items:
125-
- name: Azure DevOps CLI
126-
tocHref: /azure/devops/cli/
127-
topicHref: /azure/devops/cli/index
128-
- name: Demo Generator
129-
tocHref: /azure/devops/demo-gen/
130-
topicHref: /azure/devops/demo-gen/index
100+
- name: Install extensions
101+
tocHref: /azure/devops/marketplace/
102+
topicHref: /azure/devops/marketplace/overview
103+
- name: Develop extensions
104+
tocHref: /azure/devops/extend/
105+
topicHref: /azure/devops/extend/overview
106+
- name: Integrate applications
107+
tocHref: /azure/devops/integrate/
108+
topicHref: /azure/devops/integrate/index
109+
- name: Service Hooks
110+
tocHref: /azure/devops/service-hooks/
111+
topicHref: /azure/devops/service-hooks/overview
112+
- name: Azure Boards customization
113+
tocHref: /azure/devops/reference/
114+
topicHref: /azure/devops/reference/index
115+
items:
116+
- name: On-premises XML process
117+
tocHref: /azure/devops/reference/xml/
118+
topicHref: /azure/devops/reference/on-premises-xml-process-model
119+
- name: Process templates
120+
tocHref: /azure/devops/reference/process-templates/
121+
topicHref: /azure/devops/reference/process-templates/customize-process
122+
- name: witadmin command line
123+
tocHref: /azure/devops/reference/witadmin/
124+
topicHref: /azure/devops/reference/witadmin/witadmin-customize-and-manage-objects-for-tracking-work
125+
- name: Inherited process
126+
tocHref: /azure/devops/organizations/settings/work/
127+
topicHref: /azure/devops/organizations/settings/work/inheritance-process-model
128+
- name: Hosted XML process
129+
tocHref: /azure/devops/organizations/settings/work/hosted/
130+
topicHref: /azure/devops/organizations/settings/work/hosted-xml-process-model

docs/cli/toc.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@
1313
- name: Run commands in a release pipeline
1414
href: azure-devops-cli-in-release-pipeline.md
1515
- name: Manage permissions
16-
href: ../organizations/security/manage-tokens-namespaces.md?toc=/azure/devops/dev-resources/toc.json&bc=/azure/devops/dev-resources/breadcrumb/toc.json
16+
href: ../organizations/security/manage-tokens-namespaces.md?toc=/azure/devops/dev-resources/toc.json
1717
- name: Service connections
1818
href: service-endpoint.md
1919
- name: Troubleshoot common errors

0 commit comments

Comments
 (0)