Sean here is my idea (check the archive) We write tests and some of them we tag them <public api> or <help> and they should appear as that in the help of the package This way the programmer can even write comments in the test "I do that because this is like that and this has this effect" I tried to comment SOUP that way. Stef On Aug 31, 2011, at 1:22 PM, Sean P. DeNigris wrote:
IMHO, the biggest room for improvement is with Tests. What I loved about BDD coming from Ruby is that it forces you to write tests from the perspective of a user of the API. Often in Squeak/Pharo, I go to the tests and still have no idea how to use the classes because the tests focus on implementation details.
-- View this message in context: http://forum.world.st/The-Keys-to-the-Kingdom-tp3780556p3780712.html Sent from the Pharo Smalltalk mailing list archive at Nabble.com.