Куда мне помещать комментарии к документации? [дубликат]

На этот вопрос уже есть ответ здесь:

• Где документировать функции на C или C ++? [closed] 11 ответов

В файле заголовка, содержащем предварительные объявления, или в файле .cpp, содержащем реализации, например?

//header.h
/* About foo() */
void foo();
/* About bar() */
int bar();
/* About A */
class A
{
public:
    /* About A's constructor */
    A();
    ....
}

Или

//implementation.cpp
/* About foo() */
void foo()
{
    ...
    ...
}
/* About bar */
int bar()
{
    ...
}
/* About A's constructor */
A::A()
{
    ...
}