Class and method docs should probably be written as scala doc in case we ever build developer docs that include private classes.