renamed based on input from @jrrideout
expanded on doc string
cleaned up some terminology