Я считаю, что лучший способ обучения — это взаимодействие практики и теории. Теория должна строится на опыте полученном на практике, дополнять его и вести к более осознанной практике.
Можете подсказать примеры документации или книг, обучающих какому-то предмету, построенных на этом принципе, которые могут являться хорошим примером.
К таким примерам я отношу:
- «Облик книги» Яна Чихольда. Лучше один раз увидеть и почувствовать модульную вёрстку, чем слушать долгие объяснения.
- https://clojuredocs.org — пример хорошей документации, где многие функции языка подтверждены хорошими примерами, мечтаю, чтобы и в другой документации было так.
- www.goodui.org — мокапы, дополнены статистическими данными, идеально дополняют друг друга и дают представление, как измерить эффективность.