Documentation - return values

Docstrings need statements added to them so it's clear what each function actually returns. 

Lines of the following style:
```
:return: [ReturnDescription]
:rtype: [ReturnType]
```

need to be added to most functions.