I have improved the documentation; closes #2