coding standards: function docs