Glossary

Semantic Markup

Semantic means that you are specifying what something is, instead of how it is being used. In Sphinx this means you specify what an object is, and Sphinx handles displaying and linking it properly in the page.

Example: In HTML, <b>issue 72</b> to link an issue is bad. You’re specifying how it is displayed. <span class="issue">issue 72</span> is much better, because you are saying that the exist is an issue. Issues can then be styled independently.