style(docs): Add comments to doc custom css

Description

Abstract

Add a comment to the only one part of existing css in docs/_static/css/custom.css.

Motivation

If we add more CSS later, it would be a great idea to know why it was added, so comments are needed

Rationale

N/A

Info

Hash

e31a0e11b64de7d7ae27ab613fbeb9bc770a470f

Date

2020-09-25 23:36:21 +0200

Parents
  • chore: Fix breaking changes from updated dependencies [7c6dfe01]2020-09-25 22:54:00 +0200

Children
  • docs(source): Rename source index page to `Packages` [6646f12f]2020-09-25 23:36:22 +0200

Branches
Tags

(No tags)

Changes

docs/_static/css/custom.css

Type

Modified

Stats

+10 -9

@@ -1,3 +1,12 @@
+/* Hide class attributes because they are duplicate of the class vars found by napoleon plugins
+and those vars are more detailed.
+Side effect: If attributes are not defined in docstrings, they won't appear at all.
+ */
+dl.class > dd > dl.field-list ~ dl.attribute {
+    display: None;
+}
+
+/* Handle more levels of entries in the left sidebar */
 .wy-menu-vertical li.toctree-l3.current li.toctree-l4>ul,
 .wy-menu-vertical li.toctree-l4.current li.toctree-l5>ul,
 .wy-menu-vertical li.toctree-l5.current li.toctree-l6>ul,
@@ -24,7 +33,7 @@
     display: block
 }
 .wy-menu-vertical li.toctree-l4.current li[class*="toctree-l"]>a{
-    padding: .4045em 5.663em;
+    padding: .4045em 5.663em;
 }
 .wy-menu-vertical li.toctree-l5>a{
     padding-left: 6.663em !important;
@@ -53,11 +62,3 @@
 .wy-menu-vertical li.toctree-l13>a{
     padding-left: 14.663em !important;
 }
-
-/* Hide class attributes because they are duplicate of the class vars found by napoleon plugins
-and those vars are more detailed.
-Side effect: If attributes are not defined in docstrings, they won't appear at all.
- */
-dl.class > dd > dl.field-list ~ dl.attribute {
-    display: None;
-}