Add some documentation to issue #34