[ allow_attributes_without_reason ]: fix doc nits

This commit is contained in:
John Arundel 2024-06-03 12:38:25 +01:00
parent 35d284fcbf
commit 8da5d64669

View file

@ -270,13 +270,14 @@ declare_clippy_lint! {
declare_clippy_lint! { declare_clippy_lint! {
/// ### What it does /// ### What it does
/// Checks for attributes that allow lints without a reason. /// Checks for attributes that allow lints without specifying the reason
/// /// they should be allowed. (This requires the `lint_reasons` feature.)
/// (This requires the `lint_reasons` feature)
/// ///
/// ### Why restrict this? /// ### Why restrict this?
/// Justifying each `allow` helps readers understand the reasoning, /// There should always be a specific reason to allow a lint. This reason
/// and may allow removing `allow` attributes if their purpose is obsolete. /// should be documented using the `reason` parameter, so that readers can
/// understand why the `allow` is required, or remove it if it's no
/// longer needed.
/// ///
/// ### Example /// ### Example
/// ```no_run /// ```no_run