-- fleshing out the documentation a little more