Yeh I think proper doxygen is the way to go.