Patrice Chalin

Users are understandably confused by the current behavior, see: - The thread starting at https://github.com/open-telemetry/opentelemetry.io/pull/8504#issuecomment-3573331429 - My response, explaining the behavior: https://github.com/open-telemetry/opentelemetry.io/pull/8504#issuecomment-3575990186 I'm wondering if the smooth scrolling option helps...

While the hero image of this repo is dark, at times while scrolling, the navbar item text can be difficult to see. We need to improve the contrast. Maybe just...

### Issues/PRs in scope - [ ] [0.14.0 milestone][] - [ ] ... Also see: - [ ] List of [most-upvoted issues] [0.14.0 milestone]: https://github.com/google/docsy/milestone/22 [most-upvoted issues]: https://github.com/google/docsy/issues?q=is%3Aissue%20state%3Aopen%20sort%3Areactions-%2B1-desc [most upvoted...

Note that #2328 (section-as-root) might be able to replace the `toc_root` feature. - [ ] Ensure to document how this feature can be used in docs-only sites, even without `toc_root`....

We should maybe use these as forwarded variables, at least so we can see their full values: ```scss // scss-docs-start box-shadow-variables $box-shadow: 0 .5rem 1rem rgba($black, .15) !default; $box-shadow-sm: 0...

References: - https://fontawesome.com/changelog - https://docs.fontawesome.com/upgrade/upgrade-from-older-versions - Previous upgrade: - #1102 - #1171 Depends on: - #2279 --- When migrating from FA6 → FA7 (draft notes): **Icons are fixed-width by default**...

See https://github.com/google/docsy/blob/bd7f023e8894e68f39b86f0482efe43f25d9e318/layouts/_partials/page-meta-links.html#L31 While we're there, maybe also consider adding a UTM source, similar label, to the URL so that we can identify that it comes from Docsy's View Source link....

Entries all use the `other` form, but none can be pluralized, so they can all be of the form: ID = "value".