Никто не читал доки. Полез сам и понял: это не документация

Когда пришел в новую команду, заметил странную деталь — почти никто не читал внутреннюю документацию. Она была, причем подробная, актуальная, структурированная. Но все вопросы все равно задавали напрямую в чате, на стендапах или в личку.

Сначала я злился. Потом смирился. А потом сам полез в доку, чтобы найти один нюанс по фиче. Искал минут двадцать. Нашел. Вроде все описано, но так, что даже я, зная контекст и с десятью годами опыта, не понял ничего.

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

Ну а ту старую доку пришлось перелопатить почти всю. Потратил кучу времени, но теперь ее хотя бы читают.