Additions to doucmentation, removes some trailing whitespace

I've attempted to fill in missing PHPDocs as much as possible for Paris. I have also normalised the PHPdocs comment layout and removed a small amount of trailing whitespace that existed.

If there are any errors that pop out at you, or there's a style change needed, let me know and I'll make changes.