uv/crates/uv-dev/src
Mathieu Kniewallner 211fa91c2a
docs: separate project from configuration settings (#7053)
<!--
Thank you for contributing to uv! To help us out with reviewing, please
consider the following:

- Does this pull request include a summary of the change? (See below.)
- Does this pull request include a descriptive title?
- Does this pull request include references to any relevant issues?
-->

## Summary

Part of https://github.com/astral-sh/uv/issues/7007.

Settings documentation reference currently doesn't separate "project
metadata" and "configuration" options, implying that it's possible to
set things like `dev-dependencies` in `uv.toml` while it's not. This is
an attempt at better separating those options, by having 2 different
sections:
- `Project metadata`, that holds configuration that can only be set in
`pyproject.toml`
- `Configuration`, that holds configuration that can be set both in
`pyproject.toml` and `uv.toml`

Here are some screenshots to show what this looks like (note that I
don't have code highlighting in the right navigation, which makes them
clunky, as first item is always bigger because of the missing "span" --
I think that's because it's an `mkdocs-material` insider feature, since
I have the same thing on `main` branch):

- Right side navigation:

<img width="241" alt="Screenshot 2024-09-05 at 01 19 50"
src="https://github.com/user-attachments/assets/012f64a4-8d34-4e34-a506-8d02dc1fbf98">

<img width="223" alt="Screenshot 2024-09-05 at 01 20 01"
src="https://github.com/user-attachments/assets/0b0fb71d-c9c3-4ee3-8f6e-cf35180b1a99">

- An option from "Project metadata" section that only applies to
`pyproject.toml`:

<img width="788" alt="Screenshot 2024-09-05 at 01 20 11"
src="https://github.com/user-attachments/assets/64349fbb-8623-4b81-a475-d6ff38c658f1">

- An option from "Configuration" section that applies both to
`pyproject.toml` and `uv.toml`:

<img width="787" alt="Screenshot 2024-09-05 at 01 20 33"
src="https://github.com/user-attachments/assets/732e43d3-cc64-4f5a-8929-23a5555d4c53">

## Test Plan

Local run of the documentation.

Co-authored-by: Charlie Marsh <charlie.r.marsh@gmail.com>
2024-09-13 20:57:51 -04:00
..
clear_compile.rs Add an option to bytecode compile during installation (#2086) 2024-03-05 03:35:24 +00:00
compile.rs Add a `generate-all` step and auto-generate `settings.md` (#5080) 2024-07-15 19:58:53 +00:00
generate_all.rs Add CLI reference to `generate-all` (#5701) 2024-08-01 18:32:29 +00:00
generate_cli_reference.rs Show env option in CLI reference documentation (#6863) 2024-09-03 12:10:49 -05:00
generate_json_schema.rs Move workspace abstractions to `uv-workspace` crate (#5236) 2024-07-20 02:15:32 +00:00
generate_options_reference.rs docs: separate project from configuration settings (#7053) 2024-09-13 20:57:51 -04:00
main.rs Implement `uv build` (#6895) 2024-09-04 11:23:46 -04:00
render_benchmarks.rs Move `render-benchmarks` under a Cargo feature (#3815) 2024-05-24 03:00:53 +00:00
wheel_metadata.rs Avoid batch prefetching for un-optimized registries (#7226) 2024-09-09 15:46:19 -04:00