4 ms·
>> - as documentation Thank you for including this - it's underappreciated. So many times recently I've needed to write code against some poorly documented API
by TallGuyShort 10y ago
>> - as documentation
Thank you for including this - it's underappreciated. So many times recently I've needed to write code against some poorly documented API (not always due to lack of effort, some things are hard to document well in prose / JavaDocs, or just due to constant change), but I took one look at the unit tests and it all made sense - and I knew it was up to date for the latest work.
- Freak_NL 10y agoTests are great for dyslexic colleagues as well. A good clear concise unit test is often easier to grasp than the best of API documentation (e.g., JavaDoc in Java).
- TallGuyShort 10y agoGood point - I'd bet it applies to autism and such too.
- euyyn 10y agoI think it applies to everybody. I think it was Terence Tao who had a blog post claiming (and showing) that teaching by example first is the most effective.