Tests and Testability and Debugging and Maintainability (2017-05-18)

Tests. Tests are good. They enable us to make sure that code works correctly – or, to be more precise, that it works according to the restatement of the requirement contained in the test. Having to write tests is worthwhile all by itself. There is nothing like having to write tests to make you write code … Continue reading Tests and Testability and Debugging and Maintainability (2017-05-18)

Where Will the Docs Live? (2017-03-29)

We've been having a bit of disagreement about where docs live. Should we create enterprise-style software documentation, documenting how to install and run the software? Yes. I think so. Should we create user-level (though developer-directed) software documentation that gives example usage, API examples and the like? Sure. Good idea. And where should that documentation live? … Continue reading Where Will the Docs Live? (2017-03-29)