added a small bit of clarifying documentation
a bit more docs