proper haddock documentation with module header, examples etc.