some more haddock api documentation