better c++ code documentation (#3)