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

[Andrey Khropov]

NoiseEHC wrote:

> BTW it
> is new to me that xml comments work in /** ... */ Maybe I am not that C#
> king? :)

/** */ do work according to ECMA-334 (3rd ed). Annex E.

> With the other tags I would suggest to have 99% C# compatibility.

I mentioned that I would like to have C# compatible style possible but also
allow some more human-friendly syntax. I think XML clutters code too much even
if IDE assists you with typing.

Why write 'param' twice and 'name=' if 
method definition already says that x is a parameter with name 'x' :-) :

---------------------------------------------------
/// <param name="x">argument</param>
public f( x : int ) : int
--------------------------------------------------- ?

-- 
AKhropov