This sort of philosophy could be useful when designing a public-facing API though. In that case you need a well-formed implementation-unaware API documentation

This sort of philosophy could be useful when designing a public-facing API though. In that case you need a well-formed implementation-unaware API documentation and mapping it out upfront by hand could save you lots of trouble.