Add more descriptive doc-block style comments.

Problem/Motivation

Many of the functions have poor documentation on what the functions return.

Task is to make things better!

Steps to reproduce

Proposed resolution

Remaining tasks

User interface changes

API changes

Data model changes