updated docs

ready to merge :) for real this time