tweaked docs once more