<h3 dir="auto">Documentation Link</h3>
<p dir="auto"><a href="https://matplotlib.org/stable/api/figure_api.html?highlight=note#module-matplotlib.figure" rel="nofollow">https://matplotlib.org/stable/api/figure_api.html?highlight=note#module-matplotlib.figure</a></p>
<h3 dir="auto">Problem</h3>
<p dir="auto">The usage of</p>
<div class="snippet-clipboard-content notranslate position-relative overflow-auto" data-snippet-clipboard-copy-content="Notes
------"><pre class="notranslate"><code class="notranslate">Notes
------
</code></pre></div>
<p dir="auto">vs</p>
<div class="snippet-clipboard-content notranslate position-relative overflow-auto" data-snippet-clipboard-copy-content="Note: "><pre class="notranslate"><code class="notranslate">Note: 
</code></pre></div>
<p dir="auto">vs</p>
<div class="snippet-clipboard-content notranslate position-relative overflow-auto" data-snippet-clipboard-copy-content=".. note::"><pre class="notranslate"><code class="notranslate">.. note::
</code></pre></div>
<p dir="auto">is a bit inconsistent. As an example, the linked page use all three versions.</p>
<p dir="auto">Stats in current main (lib directory, not doc):</p>
<ul dir="auto">
<li><code class="notranslate">Note: </code>: 19</li>
<li><code class="notranslate">Notes</code>: 153</li>
<li><code class="notranslate">.. note::</code>: 59</li>
</ul>
<p dir="auto">There may for sure be a reason to use a particular approach in a gives instance, but it also may be a reason to try to make things more consistent.</p>
<h3 dir="auto">Suggested improvement</h3>
<p dir="auto">At least replace the Note: to one of the other.</p>
<p dir="auto">Replace <code class="notranslate">Notes</code> with <code class="notranslate">.. note::</code>?</p>
<h3 dir="auto">Documentation Link</h3>
<p dir="auto"><em>No response</em></p>
<h3 dir="auto">Problem</h3>
<p dir="auto">We currently have a mix of <code class="notranslate">.. notes::</code> and numpydoc Notes in the docstrings, and they render differently (compare e.g. <a href="https://matplotlib.org/devdocs/api/_as_gen/mpl_toolkits.mplot3d.axes3d.Axes3D.html#mpl_toolkits.mplot3d.axes3d.Axes3D.grid" rel="nofollow">https://matplotlib.org/devdocs/api/_as_gen/mpl_toolkits.mplot3d.axes3d.Axes3D.html#mpl_toolkits.mplot3d.axes3d.Axes3D.grid</a> and <a href="https://matplotlib.org/devdocs/api/_as_gen/mpl_toolkits.mplot3d.axes3d.Axes3D.html#mpl_toolkits.mplot3d.axes3d.Axes3D.zaxis_date" rel="nofollow">https://matplotlib.org/devdocs/api/_as_gen/mpl_toolkits.mplot3d.axes3d.Axes3D.html#mpl_toolkits.mplot3d.axes3d.Axes3D.zaxis_date</a>).  Admittedly I'm not sure we can be always consistent, because (I think?) there can be only one Notes numpydoc section whereas there can be as many <code class="notranslate">.. notes::</code> as needed with any nesting.  Perhaps we should try to improve partial consistency, or perhaps not...  Just pointing this out :)</p>
<h3 dir="auto">Suggested improvement</h3>
<p dir="auto"><em>No response</em></p>
<h3 dir="auto">Matplotlib Version</h3>
<p dir="auto">3.5.0.dev2456+g2c3f14ed28</p>
<h3 dir="auto">Matplotlib documentation version</h3>
<p dir="auto">3.5.0.dev2456+g2c3f14ed28</p>