more documentation. Resolves #3