The following is a feature request I initially sent to the SRFI editor. He asked me to submit this request on the mailing list for public discussion.

This feature request for some point in the future is to provide a specification for semantic markup for the HTML documents in which the SRFIs are written.

Let me give two example to demonstrate what I mean:

For example, at the moment, I do write:

<h2>Procedures</h2>
<p><code>(frobnicate)</code></p>
<p>Frobnicates the system state.</p>
<p><code>(secret-unfrobnicate)</code></p>
<p>Returns a secret unfrobnicator.</p>

What I would like to write would be something like the following, which
has to be supported by an accompanying style sheet:

<h2 class="procedures">Procedures</h2>
<dl class="entry-list">
   <dt class="procedure"><code class="scheme">(frobnicate)</code></dt>
   <dd>Frobnicates the system state.</dd>
   <dt class="procedure"><code
class="scheme">(secret-unfrobnicate)</code></dt>
</dl>

As another example, at the moment, I do write:

<code>(lambda &lt;formals&gt; &lt;body&gt;)</code>
<code>(zero? <em>z</em>)

What I would like to write would be:

<code class="scheme">(<span class="keyword">lambda</span> <span
class="syntax">formals</span> <span class="syntax">body</span>)</code>
<code class="scheme">(<span class="variable">zero?</span> <span
class="argument">z</span>)</code>

Again, the style sheet would have to support this (e.g. by making use of
the CSS ::before and ::after pseudo-classes and the content property).

Admittedly, the new style is longer to write (but this would be no
problem using Emacs' org-mode or some other tool) but much more
expressive and easier to process.

--