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