Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Use stripping block (|-) for page descriptions #14980

Merged
merged 1 commit into from
Dec 15, 2024

Conversation

InSyncWithFoo
Copy link
Contributor

@InSyncWithFoo InSyncWithFoo commented Dec 15, 2024

Summary

Resolves #14976.

Currently, we uses this "plain scalar" format:

description: Checks for `if key in dictionary: del dictionary[key]`.

Plain scalar must not contain the sequence : , however, so the above is invalid.

This PR changes that to:

description: |-
  Checks for `if key in dictionary: del dictionary[key]`.

| denotes a "block scalar", whereas the - chomping indicator requires that a trailing newline, if any, must be stripped.

Test Plan

@charliermarsh
Copy link
Member

Can you include a screenshot of the before and after in the test plan?

@charliermarsh charliermarsh added the documentation Improvements or additions to documentation label Dec 15, 2024
Copy link
Contributor

ruff-ecosystem results

Linter (stable)

✅ ecosystem check detected no linter changes.

Linter (preview)

✅ ecosystem check detected no linter changes.

Formatter (stable)

✅ ecosystem check detected no format changes.

Formatter (preview)

✅ ecosystem check detected no format changes.

@InSyncWithFoo
Copy link
Contributor Author

Done. I'm not sure if this breaks something else, though.

@MichaReiser
Copy link
Member

Oh nice find. This change is a bit scary because there's no good way to test its impact. I clicked through a random selection of rules and I didn't see any issues. Let's give this a try. Thank you

@MichaReiser MichaReiser merged commit 7173e6a into astral-sh:main Dec 15, 2024
21 checks passed
@InSyncWithFoo InSyncWithFoo deleted the mkdocs-descriptions branch December 15, 2024 16:20
Glyphack pushed a commit to Glyphack/ruff that referenced this pull request Dec 15, 2024
## Summary

Resolves astral-sh#14976.

Currently, we uses this "[plain
scalar](https://yaml.org/spec/1.2.2/#733-plain-style)" format:

```yaml
description: Checks for `if key in dictionary: del dictionary[key]`.
```

Plain scalar must not contain the sequence `: `, however, so the above
is invalid.

This PR changes that to:

```yaml
description: |-
  Checks for `if key in dictionary: del dictionary[key]`.
```

`|` denotes a "[block
scalar](https://yaml.org/spec/1.2.2/#81-block-scalar-styles)", whereas
[the `-` chomping
indicator](https://yaml.org/spec/1.2.2/#8112-block-chomping-indicator)
requires that a trailing newline, if any, must be stripped.

## Test Plan


![](https://github.com/user-attachments/assets/f00b606a-d6fe-46ac-a1c5-6a8665204ea3)
dcreager added a commit that referenced this pull request Dec 16, 2024
* main: (25 commits)
  [`pydocstyle`] Skip leading whitespace for `D403` (#14963)
  Update pre-commit dependencies (#15008)
  Check diagnostic refresh support from client capability (#15014)
  Update Rust crate colored to v2.2.0 (#15010)
  Update dependency monaco-editor to v0.52.2 (#15006)
  Update Rust crate thiserror to v2.0.7 (#15005)
  Update Rust crate serde to v1.0.216 (#15004)
  Update Rust crate libc to v0.2.168 (#15003)
  Update Rust crate fern to v0.7.1 (#15002)
  Update Rust crate chrono to v0.4.39 (#15001)
  Update Rust crate bstr to v1.11.1 (#15000)
  Update NPM Development dependencies (#14999)
  Update dependency ruff to v0.8.3 (#15007)
  Pin mdformat plugins in pre-commit (#14992)
  Use stripping block (`|-`) for page descriptions (#14980)
  [`perflint`] Fix panic in `perf401` (#14971)
  Improve the documentation of E201/E202 (#14983)
  [ruff_python_ast] Add name and default functions to TypeParam. (#14964)
  [red-knot] Emit an error if a bare `Annotated` or `Literal` is used in a type expression (#14973)
  [red-knot] Fix bugs relating to assignability of dynamic `type[]` types (#14972)
  ...
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[RUF051] Formatting issue for description of if-key-in-dict-del (RUF051) in docs
3 participants