fixing a lot of inline documentation so phpcs is a bit happier