playing around
update docs to reflect my indecision