docs update for #6.x #3