additional docstrings and comments
A reminder for this milestone (Blue Ridge) that as we add or modify features, we will need to accordingly add or modify our comments. Nothing is more confusing than comments next to code that don't accurately describe what's going on.