improve haddock documentation