Есть одна разница. Документация пишется один раз, и ей пользуются много пользователей. А если бремя разбираться ложится на пользователей, то это время должен потратить каждый пользователь - и это уже масштабируется плохо.
Как бы понятно, что разработчик никому ничего не должен - он просто выкладывает свои наработки с мыслью: "Если кому пригодится, то и хорошо". Но вообще конечно, это неопрятность, и я бы настороженно отнёсся к такой библиотеке. Если разработчик не удосужился написать документацию, неизвестно, чего ещё он не сделал - обработку ошибок, соблюдение стандартов и т.д. Это всё культура программирования, и по субъективным наблюдениям, всё это хорошо коррелирует друг с другом.