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