diff --git a/docs/_static/css/custom.css b/docs/_static/css/custom.css
index 227f6854..4617efcd 100644
--- a/docs/_static/css/custom.css
+++ b/docs/_static/css/custom.css
@@ -2,6 +2,9 @@
     Override styles for in-use Sphinx theme
 */
 
+/* The next two `.wy`-based rules are specifically needed for the dealing with */
+/* the `sphinx_rtd_theme` bug where long lines do not wrap in tables */
+
 /* override table width restrictions */
 .wy-table-responsive table th
 , .wy-table-responsive table td