use std::iter;
declare_clippy_lint! {
- /// **What it does:**
+ /// ### What it does
/// Detects uses of `Vec::sort_by` passing in a closure
/// which compares the two arguments, either directly or indirectly.
///
- /// **Why is this bad?**
+ /// ### Why is this bad?
/// It is more clear to use `Vec::sort_by_key` (or `Vec::sort` if
/// possible) than to use `Vec::sort_by` and a more complicated
/// closure.
///
- /// **Known problems:**
+ /// ### Known problems
/// If the suggested `Vec::sort_by_key` uses Reverse and it isn't already
/// imported by a use statement, then it will need to be added manually.
///
- /// **Example:**
- ///
+ /// ### Example
/// ```rust
/// # struct A;
/// # impl A { fn foo(&self) {} }