[ allow_attributes_without_reason ]: fix doc nits
This commit is contained in:
parent
35d284fcbf
commit
8da5d64669
@ -270,13 +270,14 @@
|
|||||||
|
|
||||||
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
|
||||||
|
Loading…
Reference in New Issue
Block a user