more doc refresh / reformat