more documentation (closes #2)