[Mono-dev] Documentation synchronization

[Miguel de Icaza]

Hello,

> Just out of curiosity. Why was this documentation approach chosen as
> opposed to e.g. source code doc comments?
> 
> A big advantage of source code doc comments is that they are available
> as you do the actual coding. With the current approach you have to
> look in a separate xml file to see documentation for a specific class
> or method or did I miss out on something?

The reasons are described on the web page I linked to on our web site.

Translations, and comfort.