improving haddock documentation