diff --git a/README.md b/README.md
index c0f678fd..92afd906 100644
--- a/README.md
+++ b/README.md
@@ -48,6 +48,20 @@ Check for files with names that would conflict on a case-insensitive filesystem
 #### `check-docstring-first`
 Checks for a common error of placing code before the docstring.
 
+> [!NOTE]
+> As raised in [#159](https://github.com/pre-commit/pre-commit-hooks/issues/159) attribute level docstrings will
+> be flagged by this. A basic workaround is to wrap the docstring with `()` which will bypass this throwing and
+> error, but could interfere with other libraries that parse them.
+
+<details><summary>Example</summary>
+
+```python
+variable = 42
+("""Attribute docstring""")
+```
+
+</details>
+
 #### `check-executables-have-shebangs`
 Checks that non-binary executables have a proper shebang.