Я также обнаружил, что написание документации к библиотеке до написания кода позволяет более ясно представить возможности и требования к ней, без продумывания деталей реализации. Это сообщает пользователю о намерениях, которыми я руководствовался при проектировании библиотеки.