Это первая статья в корпоративном блоге компании documentat.io. Мы занимаемся заказной разработкой технической документации и помогаем компаниям настраивать процессы документирования.Многие разработчики сталкиваются с тем, что писать и поддерживать документацию трудно: непонятно
Структура образов разделов, содержащих файловую систему. Часть 2. Начало публикации читайте в Часть 1. ОглавлениеЧасть 2 3.2._sparsechunk-файлы. 3.2.1.Структура _sparsechunk-файлов. 3.2.2.Примеры работы с _sparsechunk-файлами. 4.Создание dat-файлов. 4.1.Структура dat-файлов. 4.1.1.Структура transfer_list-файла.…
Продолжая тему использования Asciidoc (и других аналогичных форматов) для организации процессов непрерывного документирования, хочу рассмотреть тему автоматический генерации технической документации. Автоматическая генерация документации — распространенный, но очень расплывчатый термин. Я понимаю под этим термином извлечение для представления в удобном виде информации, содержащейся в исходном коде и настройках документируемой программы (информационной системы). Читать дальше →
Дисклеймер: это продолжение темы о составлении правильной технической документации. В первой статье мы рассказали, какие цели преследуются при составлении инфраструктурной документации и какие у нее особенности. А теперь поговорим о том, как составить годный стайлгайд, чтобы