some docs reformatted