Adding docstrings to explain shred module

A minor refactor for more sensible variable names is included.  Closes #7613.
that's neither a :+1: or a :-1: it's a  ¯\_(ツ)_/¯