Improve extend docs (#21135)

Co-authored-by: Micha Reiser <micha@reiser.io>
This commit is contained in:
chiri 2025-10-31 18:10:14 +03:00 committed by GitHub
parent 0c2cf75869
commit 9d7da914b9
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 12 additions and 5 deletions

View file

@ -59,13 +59,20 @@ pub struct Options {
)]
pub cache_dir: Option<String>,
/// A path to a local `pyproject.toml` file to merge into this
/// A path to a local `pyproject.toml` or `ruff.toml` file to merge into this
/// configuration. User home directory and environment variables will be
/// expanded.
///
/// To resolve the current `pyproject.toml` file, Ruff will first resolve
/// this base configuration file, then merge in any properties defined
/// in the current configuration file.
/// To resolve the current configuration file, Ruff will first load
/// this base configuration file, then merge in properties defined
/// in the current configuration file. Most settings follow simple override
/// behavior where the child value replaces the parent value. However,
/// rule selection (`lint.select` and `lint.ignore`) has special merging
/// behavior: if the child configuration specifies `lint.select`, it
/// establishes a new baseline rule set and the parent's `lint.ignore`
/// rules are discarded; if the child configuration omits `lint.select`,
/// the parent's rule selection is inherited and both parent and child
/// `lint.ignore` rules are accumulated together.
#[option(
default = r#"null"#,
value_type = "str",