Arvados

Feature #21018

Updated by Brett Smith 8 months ago

We use "admonitions":https://github.com/trentm/python-markdown2/wiki/admonitions for deprecation notices in the Python SDK. The HTML comes out like this: 

 <pre><code class="html"> 
 <aside &lt;aside class="admonition warning"> warning"&gt; 
     <strong>WARNING</strong> &lt;strong&gt;WARNING&lt;/strong&gt; 
     <em>Deprecated</em> &lt;em&gt;Deprecated&lt;/em&gt; 
     <p><a href="#clear_tmpdir">clear_tmpdir</a> &lt;p&gt;&lt;a href="#clear_tmpdir"&gt;clear_tmpdir&lt;/a&gt; is deprecated and scheduled to be removed in Arvados 3.0.</p> 3.0.&lt;/p&gt; 
 </aside> &lt;/aside&gt; 
 </code></pre> 

 None of this has any styling, so it's pretty plain and a little difficult to follow. Add CSS to do the following: 

 * Give the whole @aside@ block a yellow background to distinguish it from other documentation. 
 * Add content with punctuation to better separate the @strong@ and the @em@. 
 * Add @aside.admonition em { font-weight: normal; }@ 
 * Consider @aside.admonition strong { text-transform: uppercase; }@

Back