added documentation for nomenclature changes