Для тех кто хотел попробовать подход единого источника при написании технической документации, но кого смущала монстроузность настройки AsciiDoctor‘a (все эти DocBook, xslt, fopub и прочие прелести) есть альтернатива, которая позволит пощупать все прелести аскидока с легким стартом.

При написании технической документации является хорошим тоном включать секцию с историей изменений (т.н. Revision History). Как правило, сама документация также хранится в гите и имеет свою историю изменений, поэтому грех этим не воспользоваться, чтобы автоматизировать процесс.

В этой заметке буду  собирать информацию о решениях для формирования и менеджмента тактовых сигналов (преимущественно для ПЛИС), добытые из схемотехнических решений (открытых и не очень) разнообразных отладок на FPGA.

Устанавливаем зависимости:

Ставим по привычке в /opt: