expanded the documentation a bit