Т_Т

Для *.md супер! - куча плагинов проверки синтаксива, орфографии, предпросмотра и т.д.

но вообще хочется надеяться, что парсить, раскрашивать и держать в памяти DOM маркдаун-документа должно быть полегче, чем миллиона строк в джава-проекте

Вопрос по теме чата: есть xwiki, куда мы пишем статьи. Хочется сами статьи хранить в маркдауне или чем-нибудь ещё (в отдельной репе, соответственно), и потом легко их публиковать в xwiki. Наверняка есть уже велосипед, просто я не так искал? Тут ещё подвох в том, что если на самой Вики указать формат маркдауна, то всё может неожиданно расползаться во все стороны, а в стандартном формате для xwiki всё пучком.

DocOps-митап начинается с доклада о том, как вести репозиторий с документацией. Рассказывает Константин Валеев, сотрудник Ростелекома и один из авторов Foliant.

https://twitter.com/patio11/status/1184277080898338816  ""People should just read their man pages."

If you like your man pages you can keep your man pages, but there are a few million people operating systems professionally who ask their questions to Google because Google has a reputation for providing actual answers quickly.". Если пользователи ищут ответы не напрямую в документации, а в Гугле это ведь не значит, что документация плохая. Но иногда бывает, что документация действительно не полная и не покрывает какие-то сценарии, которые описаны в блогах или stackoverflow. Улучшаете ли вы документацию когда видите популярные вопросы для вашего ПО на stackoverflow или например вопрос который в google suggest появляется?