Adding docstrings to explain shred module

A minor refactor for more sensible variable names is included.  Closes #7613.