Бытует мнение, что подготовка документации — это пустая трата ресурсов, поскольку документация редко используется, но при этом ее необходимо поддерживать. Примером служат спецификации объемом в сотни страниц. Однако если документация сделана правильно, она характеризуется сочетанием легкости понимания и простоты поддержки. При этом в ней фиксируется то, что мы намереваемся создать. Документация может демонстрировать консенсус в команде и быть эффективным средством информирования людей, не входящих в команду.
Тестирование веб-API
·
Марк Винтерингем