Документация облегчает жизнь как автора комментария, так и его последователей. В своем-то коде через некоторое время не сразу разберешься что к чему, а иному уму еще хлеще рассматривать и пытаться понять, что же предполагал автор строк под той или иной инструкций. Отягчающим обстоятельством является разный уровень подготовки кодеров - один может знать о технологии или нужном классе, а другой не в курсе - здесь и недопонимание. Отсюда - комментарии - большая помощь в программировании.