Где обычно написано внутрикодовая документация классов и методов?
Вы пишете такие doc-блоки над соответствующим классом/методом в файле заголовка (.hpp) или в исходном файле (.cpp)?
Существует ли широко распространенная конвенция для таких вещей? Большинство проектов на С++ делают это в одном направлении, а не в другом?
Или должна ли быть написана документация с двух сторон (т.е. в файлах .hpp и .cpp), может быть, с одним коротким описанием одна сторона и более длинная с другой стороны?
Самое главное, есть ли какие-либо практические соображения, которые делают его более удобным для написания в одном направлении, а не в другом? (Например, использование автоматических парсеров и генераторов документации, таких как Doxygen...)