docs update for #6.x #2