Bugfix - Style and documentation consistency/issues

This PR fixes some documentation (phpDoc) style and consistency issues while also fixing some missing type-hints that were expected in the code's runtime flow.

This PR was created to address some of the issues pointed out in #222.

This is pretty much just a house cleaning PR. :+1: