once again, documentation continues to evolve and grow.  this commit is purely documentation