По документированию и чтению документации выскажу радикальную идею:
- в эпоху, когда 2 страницы уже лонгрид, снижается ценность документации и повышается ценность коммуникаций
- документация ничтожа, документирование бесценно - документирование как процесс осмысления сделанного и фактура для обсуждения и принятия решений, а не как основное средство передачи знаний
- передача знаний должна происходить в ходе коммуникаций, кик-офов, воркшопов, семинаров
Я боюсь что люди, не способные прочитать и осознать информацию с двух страниц, будут так же неспособны произвести сложное техническое решение, то есть написать код для сложной задачи.
Пусть перекрашивают кнопки в верстке или пишут тесты, это их уровень.
Не нужно стремиться все упрощать, сложность предметной области никуда не денется, только уровень инженеров будет лишь опускаться на дно.