Tidy up comments, fix bug breaking docs parser