code blocks improvements

[JohnMoehrke]

switch away from XMLname as html already has a class 'code'

<code>inline text</code>

or

>  <code class=”code-block”>A whole
>  box of text
>  without having to put any other tags
>  inside</code>
> 

ALSO need consistent formatting, as within large code blocks we have inconsistent indenting.

Might want to move full examples outside the specification now that we can reference a file published on a github.

Should be able to use language specific markup (xml looking like xml, json looking like json, etc)

[vassilpeytchev]

One point to be aware of about code-block - it takes everything between the <code> tags literally and presents it. Code blocks should look like this:

      <p>
        Some text
      </p>
      <code class="code-block">&lt;RegistryPackage&gt;
    &lt;Classification&gt;
        &lt;...&gt;
    &lt;/Classification&gt;
&lt;/RegistryPackage&gt;</code>

Note how the content needs to be right next to the <code> tags, otherwise there will be extra blank lines in the box.

[vassilpeytchev]

I think this should go to the May phase, I was close at one point to do a global replace getting 90+% done.

[MaryLJ]

Google Sheet to track progress of fixes for this issue is at https://docs.google.com/spreadsheets/d/1eM8OgzO8qGbc9Q8lEyBtwdALFOaYZN9W-AsyV6EnXWA/edit#gid=2021735577

[qligier]

Syntax highlighting would be a welcomed feature for these code blocks.

[JohnMoehrke]

Syntax highlighting would be a welcomed feature for these code blocks.

worthy new feature. This issue simply wants code blocks to be consistently marked as code blocks. That needs to come first.