another bash at fixing the docs