add some basic documentation - closes #1