В онлайн литературе, особенно технической, часто есть очень большая польза от комментариев народа, который эту книгу прочитал и может поделиться своим опытом по описываемому вопросу. Помимо традиционных комметариев которые идут после, собственно, материала, очень выгодно выгледят контектсные камменты, которые привязываются не к тексту целиком, а к каждому отдельному абзацу. Таким образом, можно увидеть все камменты относящиеся именно к данной секции и подчерпнуть для себя что-то новое не дробя при этом внимание. Опять же, очень удобный способ сообщить об ошибке, указав на нужное место.

Например, такое используется на http://djangobook.com, слева от абзацев идут пузыри, при нажатии на которые показывается окно с комментариями к данному куску текста.

Все очень наглядно и понятно, пузыри не мешают читать, находясь в стороне и при этом их хорошо видно.

Другие берут ту же идею и реализовывают ее через жопу. К примеру книга о VCS Mercurial.

Красные стрелочки подрисовал я — они указывают на ссылку, по клику на которую появляется окошко с комментариями к абзацу, после которого ссылка идет. Та же самая, по сути, функция, реализована таким образом, что ссылку на камменты от текста самой книги можно отлечить только если поднапрячся. Так или иначе, читая каждый абзац автоматически прочитываешь и «no comments».

You can enable the extension in the usual way, by editing your ~/.hgrc file. No comments.

Я называю это «автосарказмом». После каждой фразы автоматом добавляется саркастическое «без комментариев...»

— Наш продукт — самый лучший на свете! Без комментариев...
— Вы можете написать запись в блог! Без комментариев...
— В думе была принята вторая поправка! Без комментариев...

Они попытались сделать ссылку более светлой, чем обычно, но это совершенно не помогло. No comments.