comments tidy-up
stubbed a couple of placeholder functions for generating docs
fiiiiiine i'll commit this change