Fix issue #8

This addresses issue #8 

Status: **Opened for visibility**
Reviewers: @kpeatt, @ry5n
JIRA: n/a

## Changes
- This brings all the block comments to our standard, as raised in issue #8
- All functions and mixins have a standard level 1 heading
- All functions and mixins have their parameters identified in a standard way
- Dependencies are identified in a consistent way