Adding docstrings to explain shred module

A minor refactor for more sensible variable names is included.  Closes #7613.
Delete this comment? :question: