diff --git a/UPGRADING.md b/UPGRADING.md
index 5b5ef5f3d..21677631a 100644
--- a/UPGRADING.md
+++ b/UPGRADING.md
@@ -10,6 +10,14 @@ As always, [submit issues](https://github.com/FortAwesome/Font-Awesome/issues/ne
 
 ## 5.6.x to 5.7.0
 
+### OTF and TTF files
+
+The PostScript name has been changed from `FontAwesome5ProSolid` to `FontAwesome5Pro-Solid`. This was done to be more compatible with tooling such as XCode.
+
+We've also update the `Version` specifier. Font files only support a MAJOR and MINOR version number so we have modifed our schema. For example, version 5.7.0 of Font Awesome is reflected as 329.472 in the individual font files.
+
+### Icon changes
+
 The calendar-alt icon has been reverted back to the previous design in versions <= 5.6.0.
 
 ---