Improved documentation for issue #10