Будущим разработчикам может понадобиться понять, почему код организован именно так
35
.

Документация должна в первую очередь объяснять, почему было принято решение, а не какое решение было принято.