Re: [Pharo-project] Open Source and Constraints | Documentation is King

On 2 December 2012 18:57, Sven Van Caekenberghe <sven@stfx.eu> wrote:

Well written:

http://kennethreitz.org/open-source-and-constraints.html

I also find that writing documentation (minimal method/class comments or longer standalone documents) improves coding, because you take another perspective. I wouldn't value it above tests though.

"I'm designing an API and experience for myself and others as developers." That's exactly why I write tests in the first place: you write the tests to design the API. And hopefully the tests serve as good examples of how to use the API. (If they aren't good examples, you're writing your tests wrongly.) frank

Sven

-- Sven Van Caekenberghe http://stfx.eu Smalltalk is the Red Pill