documentation overhaul continued