CFY-1484 additional changes to diamond docs