code standards - function docs