CFY-1484 add initial diamond documentation