2016-09-16 15:26 GMT+02:00 Damien Pollet <damien.pol...@gmail.com>: > On 16 September 2016 at 13:42, Clément Bera <bera.clem...@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 >