I want to keep documentation primarily in source (but allowing
headers) because
it's easier for me to write it there and I think that's true for
others too, but
I would be quite happy to write stuff in the source and have you
write stuff in
the headers ... makes no difference to me (or to autogsdoc generated
documentation).
Ok - shall we then agree on this as a reasonable agreement ?
It would be nice to have all API documentation in a single place, but
we
have not reached an agreement on where (headers vs source) to put it
...
at least not yet - so I'd say for now it's a reasonable agreement.