haddocks: formatting, punctuation and linking