better use of haddock markup