Clarify comment in template

Author: jleibs

rerun_py/docs/templates/python/material/class.html

@@ -75,7 +75,8 @@
     {% set heading_level = heading_level - 1 %}
   {% endif %}
 
-  {# CHANGE: disable gating of first for root docstring #}
+  {# CHANGE Relative to Upstream: don't apply the 'first' class since it causes worse CSS formatting for our #}
+  {# generated common API index since we inline bare functions that become root-level rather than modules. #}
   {#<div class="doc doc-contents {% if root %}first{% endif %}">#}
   <div class="doc doc-contents">
     {% if config.show_bases and class.bases %}

rerun_py/docs/templates/python/material/function.html

@@ -64,9 +64,10 @@
     {% set heading_level = heading_level - 1 %}
   {% endif %}
 
-  {# CHANGE: disable gating of first for root docstring #}
+  {# CHANGE Relative to Upstream: don't apply the 'first' class since it causes worse CSS formatting for our #}
+  {# generated common API index since we inline bare functions that become root-level rather than modules. #}
   {#<div class="doc doc-contents {% if root %}first{% endif %}">#}
-  <div class="doc doc-contents {% if root %}{% endif %}">
+  <div class="doc doc-contents">
     {% with docstring_sections = function.docstring.parsed %}
       {% include "docstring.html" with context %}
     {% endwith %}