О тех.документации замолвите слово
Один из примеров превосходной документации, что мне попадались - это документация компании Atmel (линейка микроконтроллеров AVR, различные AppNotes и даже современные линейки МК серии AT SAM).
Например, даже в 2022г различные Application Notes серии AVRxxx созданные ~20лет назад остаются образчиком лаконичности и умения максимально понятно доносить информацию (возможно в английском для этого существует термин из одного слова).
А юзабилити (UI/UX?) документации на МК (Technical Reference Manual) обычно сочетается с простой и изяществом архитектурных решений (уверен что не я один подглядывал и черпал вдохновения у Атмела при проектировании SoC или её периферии 🙈).
Из более современных примеров документации хочу отметить "первый кремний" от Raspberry Pi Trading Ltd: микроконтроллер RP2040. Что хочу отметить: помимо интересных технических решений (архитектора и микроархитектура) полезных для как начинающих так и опытных чипмейкеров также хочется обратить внимание на типографику: например, способы представления тех же регистровых карт (100% автоматически генерируемых из мета-описания).
Ну и как вишенка на торте: даташит на RP2040 свёрстан на моём любимом Asciidoc 😍
❓А какие удачные примеры тех.документации попадались вам? И чем конкретно они отличны?
@embedoka
Post #771
1.63K
- 👍 6
- ❤ 1