optimise docs readability