How much time it takes to write a short comment for a class ? One minute ? Two ?

Why not help people help you ? Is it not better to make it easier to cooperate ?

On Mon, 11 Jan 2016 at 00:31, Alexandre Bergel <alexandre.bergel@me.com> wrote:
I see the motivation, but things should go incrementally. If code should be highly documented, with a high test coverage, friendly to API migration then well.. not much happens…

Cheers,
Alexandre


> On Jan 10, 2016, at 5:24 PM, Sven Van Caekenberghe <sven@stfx.eu> wrote:
>
>> I think that we should not integrate new classes if they don't have a
>> class comment that follow the template.
>
> +100
>
> I can understand that when prototype, hacking, being generally productive inside Pharo, you don't write comments at first. But once you go public, after some iterations, and especially if you want to be integrated into Pharo itself, there is no excuse. We need proper class comments, and comments for the main non-trivial public methods.

--
_,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:
Alexandre Bergel  http://www.bergel.eu
^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;.



_______________________________________________
Moose-dev mailing list
Moose-dev@list.inf.unibe.ch
https://www.list.inf.unibe.ch/listinfo/moose-dev