[nem-en] Re: Re[2]: Documentation comments clarification and proposals[Long]

[Kamil Skalski]

>
> The point is that when you change the semantics of a method and see a
> documentation comment stating the old semantics, you're more likely to
> change it, than if it hangs around somewhere in external file.
>

Yes, but for long descriptions, especially referring to classes or
some stable methods in API it  is better to move docs to external file
to do not blur the code / methods overview (in interfaces).
So I completely agree that developer should have the way to choose
between two approaches, just like in C#.

-- 
Kamil Skalski
http://nazgul.omega.pl