​​Зачем выделять внутристрочный код.

Это спонсорский пост. Боль и гнев для его написания предоставлены документацией OASIS.



Если документация рассказывает о программном коде, то все фрагменты кода должны быть отличимы от обычного текста. Для этого код внутри абзацев форматируют стилем «внутристрочный код» (inline code, вот так). Это очень помогает читать и понимать текст.



А если так не делать, то читатель будет думать, что же такое «именейшие и именоватые атрибуты»: