I am very new to Arduino and I am trying to learn the Arduino ways.
I have a lot of code experience and I have worked with embedded stuff in the past. I am looking forward to playing with the Arduino (trying to think up that killer project... :))
Anyway, I've been poking through the code and in my experience .h files are where you comment function APIs. Usually tools are used to extract the comments and build the API documentation sets.
Is there a reason function comments are lacking from the core .h files?