add documentation and samples for issue #9