I think some Spec class comments could be bigger maybe with a couple of sort examples. Now that we have an online reference for Pharo it would be important if class comments are lengthier even if the information is covered in the PFTE Spec tutorial. But I will investigate further to see what I can propose in terms of actual comments.
On Fri, Jun 20, 2014 at 11:10 AM, Yuriy Tymchuk <[email protected]> wrote: > I have not worked with spec a lot, but I think that it’s nice in terms of > comments, they are very helpful. Also lately I’ve worked with Roassal2 - no > comments at all, but you can ask Alex for help :) > > Uko > > > On 20 Jun 2014, at 10:06, kilon alios <[email protected]> wrote: > > yes good idea Damien , thank you. Right now I am working with Rubric > building a new workspace tool basing it on the rubric example. Spec and > Morphic are on my list too. > > Should I open also an issue on the bug tracker with a slice of my class > comment ? Or is posting it here enough ? > > > On Fri, Jun 20, 2014 at 10:47 AM, Damien Cassou <[email protected]> > wrote: > >> >> On Fri, Jun 20, 2014 at 9:10 AM, kilon alios <[email protected]> >> wrote: >> >>> Saying that I will start adding class comments wherever I can but >>> obviously the people that have created the code are far more qualified than >>> me . >>> >> >> >> I suggest that you ask on this mailing list when you would like to have >> documentation on a class and you can't write it yourself. That way, we all >> will read the answer. Hopefully, someone, will merge this and write a class >> comment. >> >> >> -- >> Damien Cassou >> http://damiencassou.seasidehosting.st >> >> "Success is the ability to go from one failure to another without losing >> enthusiasm." >> Winston Churchill >> > > >
