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