Status: draft, incomplete — covers what is known as of 2026-10-11.
Every place a page in the book prints a variable that has no value. A
variable is a name in <%= vars.name %> whose value comes from the
book’s config/template_variables.yml. A name is not defined when no
key in that file carries it, and empty when its key has no value. Both
print nothing on the published pages today, and the build reports
neither (survey).
After conversion every tool fails or warns on them
(convention 3).
Decision (Docs WG lead, 2026-10-11): the references are removed before
conversion, and this list stays with the Docs WG, which does the
conversion (R-24 markup cleanup
before conversion; convention 4).
The empty keys are removed from template_variables.yml as well (Docs WG
lead, 2026-10-11): the 31 that the references use, and the 20 that no
page uses; see Empty keys.
82 references, 59 names, 47 files, 9 repositories: 38 references to
28 names that are not defined, 44 to 31 names that are empty. One
reference is in a partial (_using-vol-services). Links point at the
commits the survey read (shas.txt).
How to read the tables:
<%= vars.… %> and keep the text. 24 rows.Regenerate the tables with survey/cleanup.py.
| File and line | Name | Kind | Line today | Fix |
|---|---|---|---|---|
| index.html.md.erb L36 | bbr_ert |
empty | <%= vars.bbr_ert %> |
delete the line |
| installing.html.md.erb L28 | bbr_space |
empty | * Your jumpbox must have sufficient space for the backup. <%= vars.bbr_space %> |
remove the reference |
| File and line | Name | Kind | Line today | Fix |
|---|---|---|---|---|
| java/getting-started-deploying-apps/gsg-grails.html.md.erb L6 | GSG_intro_sentence |
not defined | <%=vars.GSG_intro_sentence%> |
delete the line |
| java/getting-started-deploying-apps/gsg-grails.html.md.erb L111 | dev_console_1 |
empty | …ibes using the cf CLI to configure a ClearDB managed service instance for an app. <%=vars.dev_console_1%> |
remove the reference |
| java/getting-started-deploying-apps/gsg-grails.html.md.erb L175 | dev_console_5 |
empty | <%=vars.dev_console_5%> |
delete the line |
| java/getting-started-deploying-apps/gsg-grails.html.md.erb L205 | gen_GSG |
empty | <%= vars.gen_GSG %> |
delete the line |
| java/getting-started-deploying-apps/gsg-grails.html.md.erb L314 | dev_console_4 |
empty | …nage Your Application with the cf CLI](#cli-manage) section for more information. <%=vars.dev_console_4%> |
remove the reference |
| java/getting-started-deploying-apps/gsg-grails.html.md.erb L364 | dev_console_note |
empty | <%=vars.dev_console_note%> |
delete the line |
| java/getting-started-deploying-apps/gsg-ratpack.html.md.erb L6 | GSG_intro_sentence |
not defined | <%=vars.GSG_intro_sentence%> |
delete the line |
| java/getting-started-deploying-apps/gsg-ratpack.html.md.erb L95 | dev_console_1 |
empty | Learn how to use the CLI to configure a Redis managed service instance for an app. <%=vars.dev_console_1%> |
remove the reference |
| java/getting-started-deploying-apps/gsg-ratpack.html.md.erb L163 | dev_console_5 |
empty | <%=vars.dev_console_5%> |
delete the line |
| java/getting-started-deploying-apps/gsg-ratpack.html.md.erb L193 | gen_GSG |
empty | <%=vars.gen_GSG%> |
delete the line |
| java/getting-started-deploying-apps/gsg-ratpack.html.md.erb L285 | dev_console_4 |
empty | …nage Your Application with the cf CLI](#cli-manage) section for more information. <%=vars.dev_console_4%> |
remove the reference |
| java/getting-started-deploying-apps/gsg-ratpack.html.md.erb L335 | dev_console_note |
empty | <%=vars.dev_console_note%> |
delete the line |
| java/getting-started-deploying-apps/gsg-spring.html.md.erb L8 | GSG_intro_sentence |
not defined | <%=vars.GSG_intro_sentence%> |
delete the line |
| java/getting-started-deploying-apps/gsg-spring.html.md.erb L165 | gen_GSG |
empty | <%=vars.gen_GSG%> |
delete the line |
| java/getting-started-deploying-apps/gsg-spring.html.md.erb L258 | dev_console_4 |
empty | See [Manage your application with the cf CLI](#cli-manage) for more information. <%=vars.dev_console_4%> |
remove the reference |
| java/getting-started-deploying-apps/gsg-spring.html.md.erb L308 | dev_console_note |
empty | <%=vars.dev_console_note%> |
delete the line |
| ruby/gsg-ruby.html.md.erb L6 | GSG_intro_sentence |
not defined | <%=vars.GSG_intro_sentence%> |
delete the line |
| ruby/gsg-ruby.html.md.erb L34 | dev_console_1 |
empty | Use the cf CLI to configure a Redis Cloud managed service instance for an app. <%=vars.dev_console_1%> |
remove the reference |
| ruby/gsg-ruby.html.md.erb L117 | dev_console_5 |
empty | <%=vars.dev_console_5%> |
delete the line |
| ruby/gsg-ruby.html.md.erb L148 | gen_GSG |
empty | <%=vars.gen_GSG%> |
delete the line |
| ruby/gsg-ruby.html.md.erb L243 | dev_console_4 |
empty | …nage Your Application with the cf CLI](#cli-manage) section for more information. <%=vars.dev_console_4%> |
remove the reference |
| ruby/gsg-ruby.html.md.erb L256 | dev_console_note |
empty | <%=vars.dev_console_note%> |
delete the line |
| File and line | Name | Kind | Line today | Fix |
|---|---|---|---|---|
| enabling_ipv6.html.md.erb L26 | custom_load_balancer |
empty | 1. Set up an external load balancer for your <%= vars.app_runtime_abbr %> deployment. <%= |
remove the reference |
| listing-feature-flags.html.md.erb L70 | user_org_creation |
empty | * `user_org_creation`: Any user can create an org. <%= vars.user_org_creation %> Minimum CC API version: 2.12. |
remove the reference |
| metadata.html.md.erb L22 | metadata_ref |
not defined | <%= vars.metadata_ref %> |
delete the line |
| notifications.html.md.erb L18 | asg_notifications_prereq |
empty | <%= vars.asg_notifications_prereq %> |
delete the line |
| securing-traffic.html.md.erb L79 | ssl_cert_ert |
not defined | <%= vars.ssl_cert_ert %> |
delete the line |
| start-stop-vms.html.md.erb L14 | bosh_cli_link |
not defined | This procedure uses the BOSH Command Line Interface (BOSH CLI). <%= vars.bosh_cli_link %> |
remove the reference |
| supporting-websockets.html.md.erb L19 | or_apps_man2 |
empty | …ontroller to developers using the Cloud Foundry Command Line Interface (cf CLI) <%= vars.or_apps_man2 %>. |
remove the reference |
| troubleshooting-router-error-responses.html.md.erb L29 | gather_routing_logs |
not defined | 1. Gather the Gorouter logs and Diego Cell logs at the time of the incident. <%= vars.gather_routing_logs %> |
remove the reference |
| troubleshooting_slow_requests.html.md.erb L257 | bosh_cli_link |
not defined | Where `ROUTER-GUID` is the unique identifier for the router VM. <%= vars.bosh_cli_link %> |
remove the reference |
| troubleshooting_slow_requests.html.md.erb L322 | bosh_cli_link |
not defined | Where `ROUTER-GUID` is the unique identifier for the router VM. <%= vars.bosh_cli_link %> |
remove the reference |
| troubleshooting_slow_requests.html.md.erb L367 | bosh_cli_link |
not defined | identifier for the router VM. <%= vars.bosh_cli_link %> |
remove the reference |
| File and line | Name | Kind | Line today | Fix |
|---|---|---|---|---|
| architecture/garden.html.md.erb L35 | garden_runc |
not defined | <%= vars.garden_runc %> |
delete the line |
| architecture/index.html.md.erb L65 | blobstore_kb |
empty | …bstore as either an internal server or an external S3 or S3-compatible endpoint. <%= vars.blobstore_kb %> |
remove the reference |
| asg.html.md.erb L130 | asg_note |
not defined | <%= vars.asg_note %> |
delete the line |
| diego/diego-architecture.html.md.erb L39 | vm_note |
not defined | <%= vars.vm_note %> |
delete the line |
| diego/diego-architecture.html.md.erb L182 | best_practices_link |
not defined | … there might not be enough time to rotate the certificates before expiry. <%= vars.best_practices_link %> |
remove the reference |
| high-availability.html.md.erb L48 | external_lb |
not defined | <%= vars.external_lb %> |
delete the line |
| high-availability.html.md.erb L100 | scaling_ert |
empty | <%= vars.scaling_ert %> |
delete the line |
| high-availability.html.md.erb L114 | om_resurrector_header |
empty | <%= vars.om_resurrector_header %> |
delete the line |
| high-availability.html.md.erb L116 | om_resurrector_text |
empty | <%= vars.om_resurrector_text %> |
delete the line |
| high-availability.html.md.erb L125 | pcf_pools |
not defined | <%= vars.pcf_pools %> |
delete the line |
| high-availability.html.md.erb L130 | scaling_ert_db |
empty | backup and restore where possible. <%= vars.scaling_ert_db %> |
remove the reference |
| maintaining-high-availability.html.md.erb L16 | azs |
empty | <%= vars.azs %> |
delete the line |
| overview.html.md.erb L111 | ops_manager |
not defined | …nts access to BOSH</li><li>Holds accounts for <%= vars.ops_manager %> operators who deploy runtimes, serv… |
remove the reference |
| overview.html.md.erb L206 | concepts_sf_vs_full_header |
empty | <%= vars.concepts_sf_vs_full_header %> |
delete the line |
| overview.html.md.erb L208 | small_footprint_comparison |
empty | <%= vars.small_footprint_comparison %> |
delete the line |
| overview.html.md.erb L214 | concepts_product_model_header |
empty | <%= vars.concepts_product_model_header %> |
delete the line |
| overview.html.md.erb L219 | concepts_product_model_image |
empty | <%= vars.concepts_product_model_image %> |
delete the line |
| security.html.md.erb L146 | console_links |
empty | <%= vars.console_links %> |
delete the line |
| security.html.md.erb L211 | ipsec_note |
empty | <%= vars.ipsec_note %> |
delete the line |
| security.html.md.erb L213 | compliance_links |
not defined | <%= vars.compliance_links %> |
delete the line |
| security.html.md.erb L222 | app_svc_links |
not defined | <%= vars.app_svc_links %> |
delete the line |
| File and line | Name | Kind | Line today | Fix |
|---|---|---|---|---|
| capi/client-libraries.html.md.erb L13 | capi_link |
not defined | <%= vars.capi_link %> |
delete the line |
| deploy-apps/app-lifecycle.html.md.erb L49 | app_graceful_shutdown_config |
not defined | <%= vars.app_graceful_shutdown_config %> |
delete the line |
| deploy-apps/app-ssh-overview.html.md.erb L9 | mutual_tls_ssh |
not defined | <%= vars.mutual_tls_ssh %> |
delete the line |
| deploy-apps/cf-networking.html.md.erb L14 | app_traffic_logging |
not defined | <%= vars.app_traffic_logging %> |
delete the line |
| deploy-apps/cf-networking.html.md.erb L27 | app_man_network |
not defined | <%= vars.app_man_network %> |
delete the line |
| deploy-apps/cf-scale.html.md.erb L17 | autoscaler_note_dev_guide |
not defined | <%=vars.autoscaler_note_dev_guide%> |
delete the line |
| deploy-apps/deploy-app.html.md.erb L77 | ssl |
empty | <%= vars.ssl %> |
delete the line |
| deploy-apps/push-docker.html.md.erb L27 | docker_auth1 |
not defined | * The location of the Docker image on Docker Hub or another Docker registry. <%= vars.docker_auth1 %> |
remove the reference |
| deploy-apps/routes-domains.html.md.erb L836 | domains_on_hosted |
not defined | <%= vars.domains_on_hosted %> |
delete the line |
| deploy-apps/routes-domains.html.md.erb L902 | dns_warning |
not defined | <%= vars.dns_warning %> |
delete the line |
| deploy-apps/ssh-apps.html.md.erb L17 | mutual_tls_ssh |
not defined | <%= vars.mutual_tls_ssh %> |
delete the line |
| deploy-apps/ssh-services.html.md.erb L12 | mutual_tls_ssh |
not defined | <%= vars.mutual_tls_ssh %> |
delete the line |
| deploy-apps/streaming-logs.html.md.erb L31 | human_readable_timestamp |
empty | <%= vars.human_readable_timestamp %> |
delete the line |
| index.html.md.erb L7 | gsg_app_video_link |
not defined | <%= vars.gsg_app_video_link %> |
delete the line |
| services/_using-vol-services.html.md.erb L436 | external_vol_smb_note |
empty | <%= vars.external_vol_smb_note %> |
delete the line |
| services/route-binding.html.md.erb L9 | route_services_appsman2 |
empty | <%= vars.route_services_appsman2 %> |
delete the line |
| services/user-provided.html.md.erb L12 | user_provided_apps_man |
empty | <%= vars.user_provided_apps_man %> |
delete the line |
| using-tasks.html.md.erb L16 | tasks_ai |
empty | <%= vars.tasks_ai %> |
delete the line |
| File and line | Name | Kind | Line today | Fix |
|---|---|---|---|---|
| cli-plugin.html.md.erb L14 | configure_system_logging_link |
not defined | <%= vars.configure_system_logging_link %> |
delete the line |
| data-sources.html.md.erb L153 | custom_metrics_footnote |
not defined | <%= vars.custom_metrics_footnote %> |
delete the line |
| log-ops-guide.html.md.erb L100 | configure_system_logging_link |
not defined | …onfigure an aggregate log and metric drain for your foundation. <%= vars.configure_system_logging_link %> |
remove the reference |
| nozzle-tutorial.html.md.erb L23 | configure_system_logging_link |
not defined | aggregate log and metric drain for your foundation. <%= vars.configure_system_logging_link %> |
remove the reference |
| File and line | Name | Kind | Line today | Fix |
|---|---|---|---|---|
| hm-notifications.html.md.erb L49 | email_notifications |
empty | <%= vars.email_notifications %> |
delete the line |
| File and line | Name | Kind | Line today | Fix |
|---|---|---|---|---|
| index.html.md.erb L13 | tiledev_link |
not defined | <%= vars.tiledev_link %> |
delete the line |
| overview.html.md.erb L110 | cli_install_link |
not defined | For information about downloading, installing, and uninstalling the cf CLI, see <%= vars.cli_install_link %>. |
remove the reference |
| File and line | Name | Kind | Line today | Fix |
|---|---|---|---|---|
| uaa-user-management.html.md.erb L371 | pw_policy |
empty | <%= vars.pw_policy %> |
delete the line |
| Key | Line | References today |
|---|---|---|
product_link |
L9 | none |
asg_notifications_prereq |
L62 | 1 |
azs |
L64 | 1 |
bbr_ert |
L66 | 1 |
bbr_space |
L67 | 1 |
bbr_rn_intro |
L68 | none |
bbr_rn_compatibility |
L69 | none |
blobstore_kb |
L72 | 1 |
Cloud Foundry has used two architectures for managing application containers |
L79 | none |
cloud_controller_dea_agent |
L80 | none |
cloud_controller_dea_algorithm |
L81 | none |
concepts_sf_vs_full_header |
L84 | 1 |
concepts_product_model_header |
L85 | 1 |
concepts_product_model_image |
L86 | 1 |
small_footprint_comparison |
L87 | 1 |
console_links |
L90 | 1 |
contact_support |
L91 | none |
cookies_shared_domain_1 |
L94 | none |
custom_load_balancer |
L98 | 1 |
dea_diego_table_row |
L102 | none |
dev_console_1 |
L145 | 3 |
dev_console_3 |
L147 | none |
dev_console_4 |
L148 | 4 |
dev_console_5 |
L149 | 3 |
dev_console_note |
L150 | 4 |
domains_shared_domains |
L159 | none |
email_notifications |
L161 | 1 |
external_vol_smb_note |
L175 | 1 |
gen_GSG |
L178 | 4 |
ipsec_note |
L188 | 1 |
log_management |
L198 | none |
loggregator_log_cache_link |
L203 | none |
om_resurrector_header |
L216 | 1 |
om_resurrector_text |
L217 | 1 |
or_apps_man2 |
L218 | 1 |
pw_policy |
L226 | 1 |
route_services_apps_manager |
L236 | none |
scaling_ert_db |
L288 | 1 |
scaling_ert |
L289 | 1 |
ssl |
L298 | 1 |
tcp_port_review |
L304 | none |
user_org_creation |
L311 | 1 |
warden_garden |
L313 | none |
ssl_haproxy |
L320 | none |
tasks_ai |
L321 | 1 |
isolation_segments_create |
L323 | none |
ha_ert |
L328 | none |
route_services_appsman1 |
L329 | none |
route_services_appsman2 |
L330 | 1 |
user_provided_apps_man |
L331 | 1 |
human_readable_timestamp |
L365 | 1 |