Re: [Firebird-net-provider] Where to place documentation comments ( for 1.5 sources )

[Alessandro P. <pet...@in...>]

"Carlos Guzman Alvarez" <car...@te...> wrote in message
news:3F1...@te......

> At this moment the 1.5 sources that i have in my local tree doesn't have
> documentation comments. i'm thinking where to place it:
>
> 1- In source files.
>
> 2- In external files ( as in 1.0 and 1.1 versions )
>

Although external files are more difficult to be maintained I prefer the
second choice.
This improve readibility of the code and allow other people to modify the
documentation without working on source files.

Just my 2c.

Ciao,
Alessandro Petrelli.