A Load Of Fixes

There's quite a lot here. I'll go through them all.

1. After I added that .gitattributes file, git was complaining about the line endings on 3 of the files, so that's what the first commit is for.
2. In the facades test file, for some reason the indentation was done with 2 spaces instead of 4 spaces, so that's what the second commit fixes.
3. All docblocks should provide a short description that must end in a fullstop character, and ideally should remain on a single line.
4. The `@var` annotation is deprecated and has been replaced by the `@type` annotation.
5. The `@link` annotation is deprecated. I went for simply removing it entirely since I've updated the `@license` annotation to include the license url, which gives away the main github url.
6. There should be blank line of comment between `@param`, `@throws`, and `@returns` annotations, and the annotations should be in that order.
7. All `@param` annotations should be aligned. (this mainly wasn't an issue, although, I have corrected the types and descriptions on some of these - the same goes for the return types too)

All these docblock standards are from the psr docblock standard proposal, and I believe, are the standards phpdocumentor and sami uses.