uv/docs/guides
Mathieu Kniewallner 85be33d719
docs: use stricter validation options (#6096)
## Summary

`mkdocs` supports [validation rules for
links](https://www.mkdocs.org/user-guide/configuration/#validation),
which can be tightened to report more issues than the default
configuration. I used the recommended "maximal strictness" configuration
from the documentation.

Adding the `anchors` rule helped spot 4 errors:
```console
WARNING -  Doc file 'guides/install-python.md' contains a link '../concepts/python-versions.md#python-distributions', but the doc 'concepts/python-versions.md' does not contain an anchor '#python-distributions'.
WARNING -  Doc file 'guides/install-python.md' contains a link '../concepts/python-versions.md#discovery-order', but the doc 'concepts/python-versions.md' does not contain an anchor '#discovery-order'.
WARNING -  Doc file 'guides/projects.md' contains a link '../concepts/projects.md#lock-file', but the doc 'concepts/projects.md' does not contain an anchor '#lock-file'.
WARNING -  Doc file 'pip/environments.md' contains a link '../concepts/python-versions.md#discovery-order', but the doc 'concepts/python-versions.md' does not contain an anchor '#discovery-order'.
```

## Test Plan

Local run of the documentation + `mkdocs build --strict`.
2024-08-14 19:27:22 -05:00
..
integration Add `python-version-file` to GitHub integration documentation (#6086) 2024-08-14 10:50:37 -05:00
index.md Use prettier to format the documentation (#5708) 2024-08-02 08:58:31 -05:00
install-python.md docs: use stricter validation options (#6096) 2024-08-14 19:27:22 -05:00
projects.md docs: use stricter validation options (#6096) 2024-08-14 19:27:22 -05:00
publish.md Use uv installer during build (#5854) 2024-08-07 08:25:26 -05:00
scripts.md Add a guide for publishing packages (#5794) 2024-08-05 16:12:37 -05:00
tools.md Fixed tools guide typo (#6027) 2024-08-12 07:17:38 -04:00