tweaked docs for previous merge