Update comments for consistency, add TODOs where required
Created by: RNabel
This is the result of reading through the code base for another PR.
The main changes are:
a) corrected spelling mistakes, b) Comment formatting (capital first letter, period at end), c) TODOs where comments recommend future work.