cf-docs-rfc-proposal

Links already broken today

Status: draft, incomplete — covers what is known as of 2026-10-10. Updated 2026-10-11 with the links the cross-repository links survey found across the book, and the redirect rules whose target is gone. Updated 2026-10-12 with one anchor used four times and one id on two tables.

Links to the four test pages of the Headings round that point at a heading anchor which is not on today’s published page. They are broken before any migration, so keeping ids during conversion cannot repair them; each needs its link fixed at the source, or a redirect or added anchor (R-16 old URLs keep working). Decision (Docs WG lead, 2026-10-10): they are listed here for fixing.

Searched on 2026-10-10 against the pages as served that day (published/); every id= and name= attribute on each page, in either quote style, counts as present.

What was searched:

Code search sees default branches only, mostly skips forks and does not index large files, so every count outside the clones is a lower bound. Pinned links use the default-branch head on 2026-10-10. No source repository is archived.

Causes, with the change that broke each link, are from the history of docs-dev-guide, docs-services and docs-cf-admin.

metadata

Page: https://docs.cloudfoundry.org/adminguide/metadata.html

#-view-metadata-for-an-object is the id the site generated for the heading “View Metadata for an Object”, whose own id was view. The heading became “View metadata for a resource” in August 2019 (docs-cf-admin history), and today it appears twice, as view-cli (cf CLI) and view (API). The old heading was the API one, so the intended id is view. Every link’s text reads “Add as described here” about labels and annotations, so add-cli or add may suit the reader better.

Each repository has two hand-written lines; the other files are generated from them, so fixing the two source lines and regenerating fixes the rest.

Fragment Source (repo, linked file:line pinned) Archived? Cause Intended id
#-view-metadata-for-an-object cloudfoundry/terraform-provider-cloudfoundry, cloudfoundry/provider/utils.go L52, L63 no Id generated from older heading text; hand-written source view
#-view-metadata-for-an-object cloudfoundry/terraform-provider-cloudfoundry, docs/data-sources/buildpacks.md L45, L47 no Id generated from older heading text; generated page, fixed by the utils.go lines view
#-view-metadata-for-an-object cloudfoundry/terraform-provider-cloudfoundry, docs/data-sources/service_broker.md L33, L34 no Id generated from older heading text; generated page, fixed by the utils.go lines view
#-view-metadata-for-an-object cloudfoundry/terraform-provider-cloudfoundry, docs/data-sources/service_brokers.md L45, L46 no Id generated from older heading text; generated page, fixed by the utils.go lines view
#-view-metadata-for-an-object cloudfoundry/terraform-provider-cloudfoundry, docs/data-sources/service_route_binding.md L33, L34 no Id generated from older heading text; generated page, fixed by the utils.go lines view
#-view-metadata-for-an-object cloudfoundry/terraform-provider-cloudfoundry, docs/data-sources/service_route_bindings.md L41, L42 no Id generated from older heading text; generated page, fixed by the utils.go lines view
#-view-metadata-for-an-object cloudfoundry/terraform-provider-cloudfoundry, docs/resources/app.md L138, L153 no Id generated from older heading text; generated page, fixed by the utils.go lines view
#-view-metadata-for-an-object cloudfoundry/terraform-provider-cloudfoundry, docs/resources/buildpack.md L35, L37 no Id generated from older heading text; generated page, fixed by the utils.go lines view
#-view-metadata-for-an-object cloudfoundry/terraform-provider-cloudfoundry, docs/resources/domain.md L31, L33 no Id generated from older heading text; generated page, fixed by the utils.go lines view
#-view-metadata-for-an-object cloudfoundry/terraform-provider-cloudfoundry, docs/resources/isolation_segment.md L30, L31 no Id generated from older heading text; generated page, fixed by the utils.go lines view
#-view-metadata-for-an-object cloudfoundry/terraform-provider-cloudfoundry, docs/resources/org.md L41, L42 no Id generated from older heading text; generated page, fixed by the utils.go lines view
#-view-metadata-for-an-object cloudfoundry/terraform-provider-cloudfoundry, docs/resources/route.md L45, L48 no Id generated from older heading text; generated page, fixed by the utils.go lines view
#-view-metadata-for-an-object cloudfoundry/terraform-provider-cloudfoundry, docs/resources/service_broker.md L35, L36 no Id generated from older heading text; generated page, fixed by the utils.go lines view
#-view-metadata-for-an-object cloudfoundry/terraform-provider-cloudfoundry, docs/resources/service_credential_binding.md L45, L47 no Id generated from older heading text; generated page, fixed by the utils.go lines view
#-view-metadata-for-an-object cloudfoundry/terraform-provider-cloudfoundry, docs/resources/service_instance.md L112, L114 no Id generated from older heading text; generated page, fixed by the utils.go lines view
#-view-metadata-for-an-object cloudfoundry/terraform-provider-cloudfoundry, docs/resources/service_route_binding.md L35, L36 no Id generated from older heading text; generated page, fixed by the utils.go lines view
#-view-metadata-for-an-object cloudfoundry/terraform-provider-cloudfoundry, docs/resources/space.md L34, L36 no Id generated from older heading text; generated page, fixed by the utils.go lines view
#-view-metadata-for-an-object cloudfoundry/terraform-provider-cloudfoundry, docs/resources/user.md L34, L38 no Id generated from older heading text; generated page, fixed by the utils.go lines view
#-view-metadata-for-an-object cloudfoundry/terraform-provider-cloudfoundry, docs/resources/user_cf.md L34, L36 no Id generated from older heading text; generated page, fixed by the utils.go lines view
#-view-metadata-for-an-object SAP/crossplane-provider-cloudfoundry, apis/resources/v1alpha1/resource.go L17, L21 no Id generated from older heading text; hand-written source view
#-view-metadata-for-an-object SAP/crossplane-provider-cloudfoundry, package/crds/cloudfoundry.crossplane.io_apps.yaml L87, L137, L628, L645 no Id generated from older heading text; generated CRD, fixed by the resource.go lines view
#-view-metadata-for-an-object SAP/crossplane-provider-cloudfoundry, package/crds/cloudfoundry.crossplane.io_domains.yaml L87, L105, L310, L329 no Id generated from older heading text; generated CRD, fixed by the resource.go lines view
#-view-metadata-for-an-object SAP/crossplane-provider-cloudfoundry, package/crds/cloudfoundry.crossplane.io_organizations.yaml L87, L94, L202, L216 no Id generated from older heading text; generated CRD, fixed by the resource.go lines view
#-view-metadata-for-an-object SAP/crossplane-provider-cloudfoundry, package/crds/cloudfoundry.crossplane.io_routes.yaml L87, L186, L392, L444 no Id generated from older heading text; generated CRD, fixed by the resource.go lines view
#-view-metadata-for-an-object SAP/crossplane-provider-cloudfoundry, package/crds/cloudfoundry.crossplane.io_servicecredentialbindings.yaml L96, L189, L426, L440 no Id generated from older heading text; generated CRD, fixed by the resource.go lines view
#-view-metadata-for-an-object SAP/crossplane-provider-cloudfoundry, package/crds/cloudfoundry.crossplane.io_serviceinstances.yaml L92, L132, L523, L546 no Id generated from older heading text; generated CRD, fixed by the resource.go lines view
#-view-metadata-for-an-object SAP/crossplane-provider-cloudfoundry, package/crds/cloudfoundry.crossplane.io_serviceroutebindings.yaml L96, L103, L379, L393 no Id generated from older heading text; generated CRD, fixed by the resource.go lines view
#-view-metadata-for-an-object SAP/crossplane-provider-cloudfoundry, package/crds/cloudfoundry.crossplane.io_spaces.yaml L92, L104, L293, L312 no Id generated from older heading text; generated CRD, fixed by the resource.go lines view

troubleshooting_slow_requests

Page: https://docs.cloudfoundry.org/adminguide/troubleshooting_slow_requests.html

No broken links found. All in-page links (13 distinct fragments) resolve, and no link from another page or repository carries a fragment to this page.

access-control

Page: https://docs.cloudfoundry.org/services/access-control.html

#make-plans-public was an explicit <a id> on this page until September 2014, when the section was rewritten as “Enable Access to Service Plans” with id enable-access (docs-services d0744fa). The same id still exists on another page, services/managing-service-brokers.html#make-plans-public, which is also a valid target for these links.

Fragment Source (repo, linked file:line pinned) Archived? Cause Intended id
#make-plans-public IronFoundry/if-service-broker, README.md L36 no Explicit id removed when the section was rewritten (2014) enable-access
#make-plans-public teddyking/mongodb_broker, README.md L16 no Explicit id removed when the section was rewritten (2014) enable-access

routes-domains

Page: https://docs.cloudfoundry.org/devguide/deploy-apps/routes-domains.html

Two of the broken links are on the page itself: its source links to #http-vs-tcp-shared-domains and #create-route-w-port, and the published page shows both as dead in-page links.

Fragment Source (repo, linked file:line pinned) Archived? Cause Intended id
#create-route-w-port cloudfoundry/docs-dev-guide, deploy-apps/routes-domains.html.md.erb L394 (in-page link) no Typo of an existing id. The link read #create-route-with-port until a 2023-07-28 style edit (8ceabb1) shortened it; the id was never create-route-w-port create-route-with-port
#create-route-w-port cloudfoundry/docs-dev-guide, services/fluentd.html.md.erb L36 no Same typo, introduced by the same commit create-route-with-port
#http-vs-tcp-shared-domains cloudfoundry/docs-dev-guide, deploy-apps/routes-domains.html.md.erb L62 (in-page link) no Explicit id renamed. <a id='http-vs-tcp-shared-domains'> became http-vs-tcp-domains in the same 2023-07-28 edit (8ceabb1); the in-page link was not updated http-vs-tcp-domains
#http-vs-tcp-shared-domains pivotal-cf/docs-overops-application-reliability, docs-content/using.html.md.erb L15 no Explicit id renamed (as above) http-vs-tcp-domains
#-create-a-tcp-route-with-a-port cloudfoundry/cf-networking-onboarding, tcp-routes/010-user-workflow.markdown L125 no Heading is now an HTML <h4> with no generated id (8239f0a, 2025-04-11); the generated id was also from older heading text (“Create a TCP Route with a Port”) create-route-with-port
#-create-an-http-route-with-a-path textbook/textbook.github.io, content/development/spa-config.md L237 no Heading is now an HTML <h4> with no generated id (8239f0a, 2025-04-11) create-route-w-path
#-http-vs.-tcp-routes cloudfoundry/cf-networking-onboarding, tcp-routes/010-user-workflow.markdown L124 no Id generated from older heading text. “HTTP vs. TCP routes” became “HTTP versus TCP routes” in 2023 (8ceabb1); its generated id is now -http-versus-tcp-routes http-vs-tcp-routes

Totals

Page Fragment Links Files Repositories
metadata #-view-metadata-for-an-object 72 28 2 (terraform provider: 38 links in 19 files; crossplane provider: 34 links in 9 files)
troubleshooting_slow_requests none 0 0 0
access-control #make-plans-public 2 2 2
routes-domains #create-route-w-port 2 2 1 (docs-dev-guide)
routes-domains #http-vs-tcp-shared-domains 2 2 2
routes-domains #-create-a-tcp-route-with-a-port 1 1 1
routes-domains #-http-vs.-tcp-routes 1 1 (same file as above) 1
routes-domains #-create-an-http-route-with-a-path 1 1 1
All 7 fragments 81 35 8

The repositories are cloudfoundry/terraform-provider-cloudfoundry, SAP/crossplane-provider-cloudfoundry, IronFoundry/if-service-broker, teddyking/mongodb_broker, cloudfoundry/docs-dev-guide, pivotal-cf/docs-overops-application-reliability, cloudfoundry/cf-networking-onboarding and textbook/textbook.github.io.

Thirteen hand-written lines cover all 81 links: the 4 source lines in the two providers (the other 68 provider links follow by regeneration) and the 9 links outside the providers.

Same fragments on other hosts (not counted)

These links use a fragment that is not on today’s page, but they point at older or vendor hosts, not docs.cloudfoundry.org:

One link that looks related is valid: docs.cloudfoundry.org/services/managing-service-brokers.html#make-plans-public (Infra-Red/postgresql-service-broker-boshrelease), since that page still has the id.

Searches not completed

The cross-repository links survey resolved every link in the content of the 15 repositories the book collects, pages and partials, against a model of the book’s site, at the commits in its shas.txt. 55 links in content do not reach their target: 50 point at an id the target page does not have, 3 reach a redirect whose target is gone, and 2 point at an id bosh.io does not have. Two of them, the in-page links on routes-domains, are listed above and left out below.

Decision (Docs WG lead, 2026-10-11): these links are fixed at the source before conversion, and the redirect rules whose target is gone are dropped or retargeted (R-24 markup cleanup before conversion; cross-repository links convention 5).

A suggested fix comes from the site model and needs checking before use: an id on the same page whose spelling is close (it may be a different section), the pages that now carry the id, or for a redirect rule the pages with the same file name. “Target page” is the page the link resolves to; a link in a partial is listed once.

Regenerate the tables with cleanup.py from a run of the survey.

docs-bbr

Source Link as written Target page Problem Suggested fix
backup.html.md.erb L313 #what-to-do-with-artifact /bbr/backup.html no such id on the target page no similar id found; remove the fragment or pick a heading

docs-book-cloudfoundry

Source Link as written Target page Problem Suggested fix
master_middleman/source/contribute.html.md.erb L22 #raise-issue /contribute.html no such id on the target page #issue on the same page (similar id)

docs-buildpacks

Source Link as written Target page Problem Suggested fix
dotnet-core/index.html.md.erb L157 ../../devguide/deploy-apps/manifest.html#env-block /devguide/deploy-apps/manifest.html no such id on the target page the id is on /devguide/deploy-apps/manifest-attributes.html
go/index.html.md.erb L231 https://docs.cloudfoundry.org/adminguide/trusted-system-certificates.html / redirects to a page that is gone the redirect’s target is gone; link to the page that now covers it
hwc/extension-buildpack.html.md.erb L170 ../../devguide/deploy-apps/manifest.html#start-commands /devguide/deploy-apps/manifest.html no such id on the target page the id is on /devguide/deploy-apps/manifest-attributes.html
java/java-tips.html.md.erb L462 ../../devguide/deploy-apps/manifest.html#env-block /devguide/deploy-apps/manifest.html no such id on the target page the id is on /devguide/deploy-apps/manifest-attributes.html
php/gsg-php-composer.html.md.erb L74 ../../devguide/deploy-apps/manifest.html#env-block /devguide/deploy-apps/manifest.html no such id on the target page the id is on /devguide/deploy-apps/manifest-attributes.html
php/gsg-php-newrelic.html.md.erb L23 ../../devguide/deploy-apps/manifest.html#env-block /devguide/deploy-apps/manifest.html no such id on the target page the id is on /devguide/deploy-apps/manifest-attributes.html
php/gsg-php-usage.html.md.erb L174 ../../devguide/deploy-apps/manifest.html#env-block /devguide/deploy-apps/manifest.html no such id on the target page the id is on /devguide/deploy-apps/manifest-attributes.html
php/index.html.md.erb L106 https://docs.cloudfoundry.org/adminguide/trusted-system-certificates.html / redirects to a page that is gone the redirect’s target is gone; link to the page that now covers it
python/index.html.md.erb L81 ../../devguide/deploy-apps/manifest.html#start-commands /devguide/deploy-apps/manifest.html no such id on the target page the id is on /devguide/deploy-apps/manifest-attributes.html
python/index.html.md.erb L220 https://docs.cloudfoundry.org/adminguide/trusted-system-certificates.html / redirects to a page that is gone the redirect’s target is gone; link to the page that now covers it
r/index.html.md.erb L44 ../../devguide/deploy-apps/manifest.html#start-commands /devguide/deploy-apps/manifest.html no such id on the target page the id is on /devguide/deploy-apps/manifest-attributes.html
ruby/gsg-ror.html.md.erb L25 ../../devguide/deploy-apps/manifest.html#minimal-manifest /devguide/deploy-apps/manifest.html no such id on the target page the id is on /devguide/deploy-apps/manifest-attributes.html
ruby/sample-ror.html.md.erb L24 ../../devguide/deploy-apps/manifest.html#minimal-manifest /devguide/deploy-apps/manifest.html no such id on the target page the id is on /devguide/deploy-apps/manifest-attributes.html

docs-cf-admin

Source Link as written Target page Problem Suggested fix
cli-user-management.html.md.erb L106 ../cf-cli/getting-started.html#multi-origin /cf-cli/getting-started.html no such id on the target page the id is on /concepts/managing-roles.html
cli-user-management.html.md.erb L145 ../cf-cli/getting-started.html#multi-origin /cf-cli/getting-started.html no such id on the target page the id is on /concepts/managing-roles.html
quota-plans.html.md.erb L22 ../devguide/deploy-apps/cf-networking.html#policy-quotas /devguide/deploy-apps/cf-networking.html no such id on the target page no similar id found; remove the fragment or pick a heading
troubleshooting-router-error-responses.html.md.erb L17 #gorouter-errors /adminguide/troubleshooting-router-error-responses.html no such id on the target page #diagnose-gorouter-errors on the same page (similar id)
troubleshooting-router-error-responses.html.md.erb L204 #tls-to-back-end /adminguide/troubleshooting-router-error-responses.html no such id on the target page the id is on /concepts/http-routing.html
troubleshooting-router-error-responses.html.md.erb L291 ../concepts/http-routing.html#with-tls /concepts/http-routing.html no such id on the target page #without-tls on the same page (similar id)

docs-cloudfoundry-concepts

Source Link as written Target page Problem Suggested fix
architecture/index.html.md.erb L83 ../diego/diego-architecture.html#bbs /concepts/diego/diego-architecture.html no such id on the target page the id is on /concepts/architecture/index.html, /running/all_metrics.html
architecture/index.html.md.erb L85 ../diego/diego-architecture.html#bbs /concepts/diego/diego-architecture.html no such id on the target page the id is on /concepts/architecture/index.html, /running/all_metrics.html
asg.html.md.erb L109 #unbinding-asgs /concepts/asg.html no such id on the target page #-binding-asgs on the same page (similar id)
contribute.html.md.erb L22 #github-issue /concepts/contribute.html no such id on the target page #-raising-a-github-issue on the same page (similar id)
contribute.html.md.erb L22 #github-pr /concepts/contribute.html no such id on the target page #non-github on the same page (similar id)
roles.html.md.erb L60 ./architecture/uaa.html#scopes /concepts/architecture/uaa.html no such id on the target page the id is on /uaa/uaa-concepts.html, /uaa/uaa-deploy.html

docs-credhub

Source Link as written Target page Problem Suggested fix
hsm-config.html.md.erb L383 #establish-network-trust-link /credhub/hsm-config.html no such id on the target page #network-trust-link on the same page (similar id)
hsm-config.html.md.erb L385 #establish-network-trust-link /credhub/hsm-config.html no such id on the target page #network-trust-link on the same page (similar id)

docs-deploying-cf

Source Link as written Target page Problem Suggested fix
cf-deployment/gcp.html.md.erb L53 https://bosh.io/docs/cli-v2.html#install /content/cli-v2.md no such id on bosh.io check bosh.io for the heading’s current id
common/aws.html.md.erb L50 https://bosh.io/docs/cli-v2.html#install /content/cli-v2.md no such id on bosh.io check bosh.io for the heading’s current id

docs-dev-guide

Source Link as written Target page Problem Suggested fix
deploy-apps/_c2c_oss_logging.html.md.erb L4 #iaas /devguide/deploy-apps/cf-networking.html no such id on the target page no similar id found; remove the fragment or pick a heading
deploy-apps/_c2c_oss_logging.html.md.erb L23 #iaas /devguide/deploy-apps/cf-networking.html no such id on the target page no similar id found; remove the fragment or pick a heading
deploy-apps/_c2c_oss_logging.html.md.erb L42 #iaas /devguide/deploy-apps/cf-networking.html no such id on the target page no similar id found; remove the fragment or pick a heading
deploy-apps/_c2c_oss_logging.html.md.erb L52 #iaas /devguide/deploy-apps/cf-networking.html no such id on the target page no similar id found; remove the fragment or pick a heading
deploy-apps/deploy-app.html.md.erb L51 #custom-route /devguide/deploy-apps/deploy-app.html no such id on the target page #custom-push on the same page (similar id)
deploy-apps/deploy-app.html.md.erb L132 #custom-route /devguide/deploy-apps/deploy-app.html no such id on the target page #custom-push on the same page (similar id)
deploy-apps/environment-variable.html.md.erb L8 ./manifest.html#env-block /devguide/deploy-apps/manifest.html no such id on the target page the id is on /devguide/deploy-apps/manifest-attributes.html
deploy-apps/manifest-attributes.html.md.erb L506 ../../cf-cli/getting-started.html#find-app /cf-cli/getting-started.html no such id on the target page no similar id found; remove the fragment or pick a heading
deploy-apps/routes-domains.html.md.erb L388 #create-route-w-port /devguide/deploy-apps/routes-domains.html no such id on the target page #create-route-with-port on the same page (similar id)
deploy-apps/routes-domains.html.md.erb L397 ../deploy-apps/manifest.html#routes /devguide/deploy-apps/manifest.html no such id on the target page the id is on /devguide/deploy-apps/manifest-attributes.html, /devguide/deploy-apps/routes-domains.html
deploy-apps/ssh-apps.html.md.erb L11 ../../cf-cli/http-proxy.html#v3-ssh-socks5 /cf-cli/http-proxy.html no such id on the target page no similar id found; remove the fragment or pick a heading
services/_using-vol-services.html.md.erb L48 ../deploy-apps/manifest.html#services-block /devguide/deploy-apps/manifest.html no such id on the target page the id is on /devguide/deploy-apps/manifest-attributes.html
services/application-binding.html.md.erb L213 ../deploy-apps/manifest.html#services-block /devguide/deploy-apps/manifest.html no such id on the target page the id is on /devguide/deploy-apps/manifest-attributes.html
services/managing-services.html.md.erb L213 ../deploy-apps/manifest.html#services-block /devguide/deploy-apps/manifest.html no such id on the target page the id is on /devguide/deploy-apps/manifest-attributes.html

docs-loggregator

Source Link as written Target page Problem Suggested fix
container-metrics.html.md.erb L143 #cpu-mem-disk /loggregator/container-metrics.html no such id on the target page #cf-mem-disk on the same page (similar id)
log-ops-guide.html.md.erb L81 ../running/managing-cf/logging-config.html#scaling /running/managing-cf/logging-config.html no such id on the target page the id is on /devguide/deploy-apps/rolling-deploy.html, /devguide/services/oms-nozzle.html, /loggregator/log-ops-guide.html
opentelemetry.html.md.erb L123 #logging-and-metrics /loggregator/opentelemetry.html no such id on the target page no similar id found; remove the fragment or pick a heading

docs-running-cf

Source Link as written Target page Problem Suggested fix
metrics/_cloud_controller.html.md.erb L4 #cc_worker /running/all_metrics.html no such id on the target page no similar id found; remove the fragment or pick a heading

docs-services

Source Link as written Target page Problem Suggested fix
binding-credentials.html.md.erb L15 ../devguide/services/managing-services.html#use /devguide/services/managing-services.html no such id on the target page the id is on /adminguide/stack-auditor.html

docs-uaa

Source Link as written Target page Problem Suggested fix
uaa-concepts.html.md.erb L12 #user-groups /uaa/uaa-concepts.html no such id on the target page #-user-groups on the same page (similar id)
uaa-concepts.html.md.erb L88 #shadow /uaa/uaa-concepts.html no such id on the target page ##shadow on the same page (similar id)
uaa-deploy.html.md.erb L30 #local /uaa/uaa-deploy.html no such id on the target page #demo-local on the same page (similar id)

Redirect rules whose target is gone

30 of the 85 rules in the book’s redirects.rb send a reader to a page that no longer exists. A static host writes each rule as a page, so each is dropped or given a new target before conversion (R-16 old URLs keep working). Rule L48 can never match, because its source holds a # part, which browsers do not send; it does nothing and can go with them.

Rule From To (missing) Suggested target
L7 /console/cf-api-endpoint.html /running/cf-api-endpoint.html /running/archive/cf-api-endpoint.html
L9 %r{/deploying/ec2/.*} /deploying/aws/index.html /deploying/common/aws.html
L11 /deploying/openstack/deploying_bosh.html /deploying/openstack/index.html none by file name; drop the rule or pick a page
L12 /deploying/openstack/deploying_microbosh.html /deploying/openstack/index.html none by file name; drop the rule or pick a page
L13 /deploying/openstack/uploading_bosh_stemcell.html /deploying/openstack/index.html none by file name; drop the rule or pick a page
L15 /deploying/vsphere/bosh-example-manifest.html /deploying/vsphere/index.html none by file name; drop the rule or pick a page
L16 /deploying/vsphere/deploying_bosh_with_micro_bosh.html /deploying/vsphere/index.html none by file name; drop the rule or pick a page
L17 /deploying/vsphere/deploying_micro_bosh.html /deploying/vsphere/index.html none by file name; drop the rule or pick a page
L18 /deploying/vsphere/install-and-prepare-vsphere.html /deploying/vsphere/index.html none by file name; drop the rule or pick a page
L20 /deploying/vcloud/bosh-example-manifest.html /deploying/vcloud/index.html none by file name; drop the rule or pick a page
L21 /deploying/vcloud/deploying_bosh_with_micro_bosh.html /deploying/vcloud/index.html none by file name; drop the rule or pick a page
L22 /deploying/vcloud/deploying_micro_bosh.html /deploying/vcloud/index.html none by file name; drop the rule or pick a page
L23 /deploying/vcloud/micro-bosh-example-manifest.html /deploying/vcloud/index.html none by file name; drop the rule or pick a page
L25 /deploying/boshlite/deploy_cf_boshlite.html /deploying/boshlite/index.html none by file name; drop the rule or pick a page
L27 /deploying/cf-stub-aws.html /deploying/aws/cf-stub.html none by file name; drop the rule or pick a page
L28 /deploying/cf-stub-openstack.html /deploying/openstack/cf-stub.html none by file name; drop the rule or pick a page
L29 /deploying/cf-stub-vsphere.html /deploying/common/vsphere-vcloud-cf-stub.html none by file name; drop the rule or pick a page
L30 /deploying/cf-stub-vcloud.html /deploying/common/vsphere-vcloud-cf-stub.html none by file name; drop the rule or pick a page
L40 /devguide/deploy-apps/api-endpoint.html /running/cf-api-endpoint.html /running/archive/cf-api-endpoint.html
L43 %r{/devguide/installcf/(.*)} /cf-cli/$1 none by file name; drop the rule or pick a page
L44 %r{/devguide/cf-cli/(.*)} /cf-cli/$1 none by file name; drop the rule or pick a page
L57 /running/api/version.html /running/cf-api-endpoint.html /running/archive/cf-api-endpoint.html
L78 /services/volume-services-v2.10.html /devguide/services/volume-services.html none by file name; drop the rule or pick a page
L79 /services/volume-services-v2.9.html /devguide/services/volume-services.html none by file name; drop the rule or pick a page
L85 /adminguide/trusted-system-certificates.html /running/trusted-system-certificates.html /devguide/deploy-apps/trusted-system-certificates.html, /running/archive/trusted-system-certificates.html
L86 /adminguide/deploy-vol-services.html /running/deploy-vol-services.html /running/archive/deploy-vol-services.html
L95 /deploying/aws/setup_aws.html /deploying/aws/setup_bosh_aws.html none by file name; drop the rule or pick a page
L97 /concepts/architecture/execution-agent.html /concepts/diego/dea-vs-diego.html none by file name; drop the rule or pick a page
L98 /concepts/architecture/dea-algorithm.html /concepts/diego/dea-vs-diego.html none by file name; drop the rule or pick a page
L99 /concepts/architecture/warden.html /concepts/diego/dea-vs-diego.html none by file name; drop the rule or pick a page

One anchor used four times: uaa-performance (2026-10-12)

Page: https://docs.cloudfoundry.org/running/uaa-performance.html

Found while linking the tables test pages to their tables on the published page. The source gives the headings of all four sections the same anchor, <a id='client-credentials'></a>, so #client-credentials reaches only the first section; the other three cannot be linked by an anchor of their own. Each heading also lacks the space after ###, so the published page gives it a second, generated id that starts with a hyphen (-password-grant-type).

Source (docs-running-cf, pinned) Heading Ids on the published page Suggested fix (to check)
L84 Client credentials grant type client-credentials, -client-credentials-grant-type keep client-credentials; add the space after ###
L169 Password grant type client-credentials (again), -password-grant-type a new id such as password; add the space
L254 Authorization code grant type client-credentials (again), -authorization-code-grant-type a new id such as authorization-code; add the space
L305 Implicit grant type client-credentials (again), -implicit-grant-type a new id such as implicit; add the space

Links to the hyphen-prefixed ids were not searched for; adding the space changes those ids, so a search should come before the fix.

One id on two tables: roles (2026-10-12)

Page: https://docs.cloudfoundry.org/concepts/roles.html

Found while adding the roles table as a test page. Two partials included by roles.html.md.erb open their table with the same id, so the published page has oss-roles-permissions twice; #oss-roles-permissions reaches only the first table, and the second has no id of its own.

Source (docs-cloudfoundry-concepts, pinned) Table Suggested fix (to check)
_oss_roles_table.html.md.erb L1 Roles and permissions for active orgs keep oss-roles-permissions
_suspended_org_roles_table.html.md.erb L1 Roles and permissions for suspended orgs a new id such as oss-suspended-org-roles-permissions, in the pattern of the suspended spaces table’s oss-suspended-space-roles-permissions

Links to #oss-roles-permissions were not searched for.