Two `404 - page not found` errors from a uv doc file to other uv doc files.

[hunterhogan]

These two links are not found.

uv/docs/reference/index.md

Lines 5 to 6 in add376f

	- [Commands](./cli.md): A reference for uv's command line interface.
	- [Settings](./settings.md): A reference for uv's configuration schema.

1. I searched branch main for the file names, but I didn't find replacements.
2. The other four links in the markdown file are working.

[woodruffw]

@hunterhogan Can you elaborate on what you're seeing here? Those links are functional on the actual site, since they're links to Markdown files that are generated at publish time:

https://docs.astral.sh/uv/reference/

(There's no expectation that they work as raw references, only when built as our public documentation.)

[hunterhogan]

@hunterhogan Can you elaborate on what you're seeing here? Those links are functional on the actual site, since they're links to Markdown files that are generated at publish time:

https://docs.astral.sh/uv/reference/

(There's no expectation that they work as raw references, only when built as our public documentation.)

I was on the website, and I saw some changes I wanted to suggest, so I came to GitHub. While looking for the files necessary for a PR, I discovered the two 404s.

I don't know what changes ought to be made, but this situation clearly demonstrates that the current system "will be hard to remember/maintain over time." At least two people tried to contribute to uv but were thwarted by the system. And our attempts to help created extra work for Astral.

[zanieb]

It's intentional that the markdown documentation does not have functional links to the generated reference documentation. I'm not sure what else to say. When they existed in the repository, people manually edited them all the time, which is not the proper workflow anyway.

[hunterhogan]

You're welcome for my suggestion that you or "people" commit an impropriety.