The problem is that documenting frameworks is difficult. You should
build cookbook.
stef
On 20/6/14 12:21, kilon alios wrote:
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 <yuriy.tymc...@me.com
<mailto:yuriy.tymc...@me.com>> 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 <kilon.al...@gmail.com
<mailto:kilon.al...@gmail.com>> 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
<damien.cas...@gmail.com <mailto:damien.cas...@gmail.com>> wrote:
On Fri, Jun 20, 2014 at 9:10 AM, kilon alios
<kilon.al...@gmail.com <mailto:kilon.al...@gmail.com>> 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
<http://damiencassou.seasidehosting.st/>
"Success is the ability to go from one failure to another
without losing enthusiasm."
Winston Churchill
