1 files changed, 12 insertions, 15 deletions

diff --git a/lib/src/lints/bool_comparison.rs b/lib/src/lints/bool_comparison.rs
index 6636faf..5c9bee8 100644
--- a/lib/src/lints/bool_comparison.rs
+++ b/lib/src/lints/bool_comparison.rs
@@ -7,28 +7,25 @@ use rnix::{
     NodeOrToken, SyntaxElement, SyntaxKind, SyntaxNode,
 };
 
-/// What it does
-/// ------------
-/// Checks for expressions of the form x == true, x != true and
+/// ## What it does
+/// Checks for expressions of the form `x == true`, `x != true` and
 /// suggests using the variable directly.
 ///
-/// Why is this bad?
-/// ----------------
+/// ## Why is this bad?
 /// Unnecessary code.
 ///
-/// Example
-/// --------
-/// Instead of checking the value of x:
+/// ## Example
+/// Instead of checking the value of `x`:
 ///
-///     if x == true
-///     then 0
-///     else 1
+/// ```
+/// if x == true then 0 else 1
+/// ```
 ///
-/// Use x directly:
+/// Use `x` directly:
 ///
-///     if x
-///     then 0
-///     else 1
+/// ```
+/// if x then 0 else 1
+/// ```
 #[lint(
     name = "bool_comparison",
     note = "Unnecessary comparison with boolean",