Zur ersten Frage:
Funktionen stehen niemals in einer Header-Datei (außer inline-Funktionen).
In eine Header-Datei gehören ausschließlich Deklarationen (bitte nicht verwechseln mit Definition).

Zur zweiten Frage kann ich nicht viel sagen, weil ich den Roboter nicht kenne.

Gute Dokumentation ist ein sehr guter Vorsatz, dafür kann ich Dir doxygen wärmstens empfehlen.

Gruß,
askazo