updates
update including a bit of documentation