cf-docs-rfc-proposal

Intent: routes-domains (Domains section)

Cases this section covers

Heading tree to keep

Only the Domains section is converted (see SOURCES); the outline check compares the page title and that section (--section domains).

h1 Configuring routes and domains
  h2 Domains                                                     #domains
    h3 List domains for an org                                   #list-domains
    h3 HTTP versus TCP domains                                   #http-vs-tcp-domains
    h3 Shared domains                                            #shared-domains
      h4 Create a shared domain           (HTML <h4> in source)  #create-shared-domain
      h4 Delete a shared domain           (HTML <h4> in source)  #delete-shared-domain
      h4 Internal domain                  (HTML <h4> in source)  #internal-domains
    h3 Private domains                                           #private-domains
      h4 Create a private domain          (HTML <h4> in source)  #create-private-domain
      h4 Sharing a private domain with one or more orgs  (HTML <h4> in source)  #sharing-private-domains
      h4 Delete a private domain                                 #delete-private-domain
    h3 Requirements for parent and child domains                 #parent-child-domains
    h3 DNS for domains                                           #domains-dns
      h4 Mapping Domains to your custom domain                   #subdomain-dns
        h5 Mapping a single domain to your custom domain         #single-mapping
        h5 Mapping multiple subdomains to your custom domain     #wildcard-mapping
      h4 Configuring DNS for your registered root domain         #root-domain-dns

An HTML heading and a Markdown heading are the same heading. Decision (this round): the outline counts both, and a native conversion writes both as the tool’s own heading syntax. On the published page they differ in two ways that a reader can see: an HTML heading gets no generated id, and the page’s quick links (its table of contents) list only ## and ### headings that start with an <a id>, so neither kind of #### appears there. Bookbinder’s quick-links code: quicklinks_renderer.rb (tag v9.12.0; the book’s Gemfile pins bookbindery 9.12.1, which has no tag on GitHub; the file is the same in the 9.12.1 gem published on rubygems.org).

Anchors to keep

The 17 explicit ids above, listed in routes-domains.anchors.

Links into the Domains section, found in the clones of the docs repositories and by GitHub code search on 2026-10-10. Code search counts are lower bounds.

Anchor Linked from
#domains docs-cf-admin enabling-tcp-routing.html.md.erb L72; SAP-docs/btp-cloud-platform; vmware-tanzu/tanzu-dev-portal; two more
#private-domains three pages in SAP-docs/btp-cloud-platform, sap-tutorials/btp-foundation, two more; this page
#shared-domains SAP-docs/btp-custom-domain-service; pivotal/blog; this page
#domains-dns swisscom/docs-appcloud-devguide; one more; this page

The rest of the page (the Routes section) is linked more: #internal-routes, #map-route, #routes, #surgical-routing, #http-vs-tcp-routes, #create-route and others, from CF repositories such as docs-cf-admin and from outside them. They are outside the excerpt.

Already broken on the published page (none of these ids is on the page; the first four point into the Routes section; full list with causes: broken-links.md). Two of them are also linked from this page’s own source: #create-route-w-port (L394) and #http-vs-tcp-shared-domains (L62).

Deviations

None in the headings. The body needed tool-specific changes for variables in code (see the results).

Checks

python3 -I ../checks/outline.py ../published/routes-domains.html BUILT.html --anchors routes-domains.anchors --section domains