#97 introduce a stream factory for scanning inputstreams
split up documentation