Various doc and comment fixes

I have a branch with various doc and comment fixes, I just need a ticket number.

To upload designs, you'll need to enable LFS and have an admin enable hashed storage. More information