updates to docs, more needs to be done...