Adding docstrings to explain shred module

A minor refactor for more sensible variable names is included.