Bug 1912808 - Fix document generation warnings from Glean docs. r=chutten

Differential Revision: https://phabricator.services.mozilla.com/D220493

docs/config.yml

@@ -126,4 +126,4 @@ fatal warnings:
     - "WARNING: '([^']*)' reference target not found:((?!.rst).)*$"
     - "WARNING: Include file '([^']*)' not found or reading it failed"
 
-max_num_warnings: 845
+max_num_warnings: 844

toolkit/components/glean/docs/user/glean_for_legacy_events.md

@@ -42,11 +42,11 @@ which means that testing the Legacy Telemetry event or seeing its value in `abou
 [requires a full, compiled build][artifact-support-gifft].
 
 [new-metrics-yaml]: ./new_definitions_file.md#where-do-i-define-new-metrics-and-pings
-[glean-events-vs]: ./migration.md#events-use-glean-s-event
+[glean-events-vs]: ./migration.md#events---use-gleans-event
 [glean-event-doc]: https://mozilla.github.io/glean/book/reference/metrics/event.html
 [sample-event-defn]: https://mozilla.github.io/glean/book/reference/metrics/event.html#metric-parameters
 [gifft]: ./gifft.md
-[legacy-enum-name]: ./gifft.md#the-telemetry-mirror-property-in-metrics-yaml
+[legacy-enum-name]: ./gifft.md#the-telemetry_mirror-property-in-metricsyaml
 [glean-event-api]: https://mozilla.github.io/glean/book/reference/metrics/event.html#recordobject
 [glean-test-api]: https://mozilla.github.io/glean/book/reference/metrics/event.html#testing-api
 [artifact-support-gifft]: ./gifft.md#artifact-build-support

toolkit/components/glean/docs/user/instrumentation_tests.md

@@ -47,7 +47,7 @@ you're going to want to write some automated tests.
     * You might be able to assert that the value is at least as much as a known, timed value,
       but beware of rounding.
     * If your metric is a `timing_distribution` mirroring to a Telemetry probe via [GIFFT](./gifft.md),
-      there may be [small observed differences between systems](./gifft.md#timing-distribution-mirrors-samples-and-sums-might-be-different)
+      there may be [small observed differences between systems](./gifft.md#timing_distribution-mirrors-samples-and-sums-might-be-different)
       that can cause equality assertions to fail.
 * Errors in instrumentation APIs do not panic, throw, or crash.
   But Glean remembers that the errors happened.