Писал комментарий к статье и понял, что надо выносить в отдельный пост.
Как многие отмечают там в комментариях статья отстой, человек не разбирается и смешал всё в кучу, попробую поделиться своими выводами от использования разных разметок.
Читать полностью »
Рубрика «docbook»
Семантическая разметка: LaTeX, DocBook или ???
2017-10-05 в 15:20, admin, рубрики: asciidoc, docbook, doconce, latex, markdown, open source, XML, xslt, документирование, Семантика, семантическая разметкаДокументация Linux ядра переходит на Python Sphinx
2016-12-07 в 18:10, admin, рубрики: docbook, linux kernel, open source, python, sphinx, документация, Разработка под LinuxLinux ядро на сегодняшний день — самый динамичный, сложный, крупный проект с открытым кодом. Как же обстоят дела с его документацией? Существует прямая связь: чем качественнее и доступнее документация проекта, тем проще для посторонних изучить основы дела, освоиться и стать полноправным участником.
На семинаре Kernel Recipies мейнтейнер документации Linux ядра Jonathan Corbet рассказал о нынешнем положении дел с документацией и о том, как будет совершаться переход от анархии к порядку. Первые успехи в этом начинании уже есть. Некоторые документы были недавно конвертированы в ReStructuredText
с помощью питоновского Сфинкса. О том как это было рассказано внутри.
Документирование программ
2015-02-09 в 13:49, admin, рубрики: docbook, html, markdown, pandoc, XML, xsl, разработка На определенном этапе развития программной системы неизбежно возникает задача разработки пользовательской документации. И тут возникает технический вопрос выбора форматов и инструментов разработки документации.
Читать полностью »