From 9856c1446b6971d7601d02198778ffc0bfc69e40 Mon Sep 17 00:00:00 2001
From: Charlie Marsh <charlie.r.marsh@gmail.com>
Date: Sun, 24 Mar 2024 22:46:33 -0400
Subject: [PATCH] Document use of anonymous assignment in `useless-expression`
 (#10551)

Closes https://github.com/astral-sh/ruff/issues/10536.
---
 .../rules/useless_expression.rs               | 20 +++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/crates/ruff_linter/src/rules/flake8_bugbear/rules/useless_expression.rs b/crates/ruff_linter/src/rules/flake8_bugbear/rules/useless_expression.rs
index 5c4f22c46c..ea0795ca1f 100644
--- a/crates/ruff_linter/src/rules/flake8_bugbear/rules/useless_expression.rs
+++ b/crates/ruff_linter/src/rules/flake8_bugbear/rules/useless_expression.rs
@@ -25,6 +25,26 @@ use super::super::helpers::at_last_top_level_expression_in_cell;
 /// ```python
 /// foo = 1 + 1
 /// ```
+///
+/// ## Known problems
+/// This rule ignores expression types that are commonly used for their side
+/// effects, such as function calls.
+///
+/// However, if a seemingly useless expression (like an attribute access) is
+/// needed to trigger a side effect, consider assigning it to an anonymous
+/// variable, to indicate that the return value is intentionally ignored.
+///
+/// For example, given:
+/// ```python
+/// with errors.ExceptionRaisedContext():
+///     obj.attribute
+/// ```
+///
+/// Use instead:
+/// ```python
+/// with errors.ExceptionRaisedContext():
+///     _ = obj.attribute
+/// ```
 #[violation]
 pub struct UselessExpression {
     kind: Kind,