adding documentation... making things easy for the next update and #2