ENH improving docs section based on inch-ci recommendations