Thursday, November 1, 2007

Documentation is the final test of a design

Just a small observance: Writing documentation forces you to create a good API to your program. Several times today I was trying to describe in writing how to use genetify and I realized that it was unnecessarily complicated or unclear. It's hard to write good documentation because programs often don't operate the way someone would naturally expect. And that's bad.

No comments: