Comments 8
отдельный + за хабракат
Недавно пытался сформулировать требования к инструментам подготовки документации. То что получилось запостил вопросом habrahabr.ru/qa/47956/
Интересный проект.
Хотя когда дошел до компонентов испытал странное чувство. Неоднозначно. По крайней мере в разрезе использования md разметки.
Почему? Потому, что маркдаун это легкая текстовая разметка, читабельная и понятная и без обработчиков. Легкая в переносе и т.п.
А вот компоненты начинают в нее вносить трудночитаемые (трудно переносимые) конструкции.
Но это личное дело каждого, использовать их или нет.
Хотя когда дошел до компонентов испытал странное чувство. Неоднозначно. По крайней мере в разрезе использования md разметки.
Почему? Потому, что маркдаун это легкая текстовая разметка, читабельная и понятная и без обработчиков. Легкая в переносе и т.п.
А вот компоненты начинают в нее вносить трудночитаемые (трудно переносимые) конструкции.
Но это личное дело каждого, использовать их или нет.
Совершенно верно, можно не использовать расширения. Оставляете только один блок в коде странички
И пишете внутри блока «читабельный и понятный и без обработчиков, легкий в переносе и т.п.» Markdown. И даже не нужно ничего дополнительно копировать, устанавливать. То есть я к тому, что и ваши пожелания учтены.
<!--content-panel
# Заголовок
текст
-->
И пишете внутри блока «читабельный и понятный и без обработчиков, легкий в переносе и т.п.» Markdown. И даже не нужно ничего дополнительно копировать, устанавливать. То есть я к тому, что и ваши пожелания учтены.
Sign up to leave a comment.
Веб-справка, веб-документы. Еще проще