<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"></head><body dir="auto"><div></div><div style="direction: inherit;">Hi Andrew,</div><div><br>...</div><blockquote type="cite"><div><div dir="ltr"><div>For what it is worth, I also believe that documentation should be with the declaration simply because the header files are the ones people tend to first look at not the definition. This is what VTK currently does. ...</div></div></div></blockquote><div style="direction: inherit;"><br></div><div style="direction: inherit;">I think that moving method (not class) documentation out of the headers makes the headers much more terse and legible. For the vast majority of classes, the method names themselves are enough documentation. In cases where method names are not enough, it is nice to have the implementation nearby. Methods with inline or macro-generated implementations would still have documentation in the header, as would enums.</div><div style="direction: inherit;"><br></div><div style="direction: inherit;"> David</div></body></html>