2016-09-16 15:26 GMT+02:00 Damien Pollet <damien.pollet@gmail.com>:
On 16 September 2016 at 13:42, Clément Bera <bera.clement@gmail.com> wrote:
Why don't you just change nautilus to have two text areas, one with the test corresponding to the method and the other one with the method's code ?
Exactly, we already have that with class comments, so why not methods (and while we're at it, package comments too)
Could we have a Pillar-way of organizing comments so that, based on sections, one could automatically find, from a book-like comment of the package or the class, which section applies to a given method?
A separate method comment would make it clear that it's intended as API documentation for users of the method (and then the comment inside the method's source can be really a development comment). Another advantage is that its syntax won't have to deal with being between quotes and all the indentation/escapement hassles that come with inserting a syntax inside another oneâ¦
Good point. Thierry
-- Damien Pollet type less, do more [ | ] http://people.untyped.org/damien.pollet