fornax.net

I can't sleep, so I figured I'd wade into the inline documentation debate.

Travis states that programming languages are declarative, so code, along with associated unit tests are enough to define what the code does, as well as provide examples of how to use the code.

Well, I agree with that.

However, that doesn't mean that inline documentation is therefore a "bad thing". Tobias has pointed out a couple of reasons why that's the case. I can think of a couple more, too.

Cathy and I went to Brugge over the Easter long weekend. No complaints

Photos are up in the gallery.