Complete documentation and streamline coding style a bit

• Contains the completed documentation
• Resolves Issue #1 (closed) (namespace inconsistencies)
• Change some variable names for consistency

added Documentation Fix labels

assigned to @paulenit

merged

mentioned in commit ce99af67