* Polished the public documentation

David Lassonde · David Lassonde · commit 7e0679e6410b · 2018-06-18T11:06:13.000-04:00
diff --git a/Packages/Documentation/com.autodesk.fbx/Alpha/CHANGELOG.md b/Packages/Documentation/com.autodesk.fbx/Alpha/CHANGELOG.md
@@ -1,6 +1,6 @@
 # Changes in FBX SDK C# Bindings
 
-## [2.0.0] - 2018-06-14
+## [2.0.0] - 2018-06-18
 
 * No change since 1.7.0. Synchronizing the version number with the com.unity.formats.fbx package
 
diff --git a/Packages/Documentation/com.autodesk.fbx/Public/CHANGELOG.md b/Packages/Documentation/com.autodesk.fbx/Public/CHANGELOG.md
@@ -1,81 +1,28 @@
 # Changes in FBX SDK C# Bindings
 
-## [2.0.0] - 2018-06-14
-
-* No change since 1.7.0. Synchronizing the version number with the com.unity.formats.fbx package
-
-## [1.7.0] - 2018-06-01
-
-FEATURE
+## [2.0.0] - 2018-06-18
 
+NEW FEATURES
 * The C# Bindings package has been renamed to com.autodesk.fbx
-* Fixed violations of the C# Framework Design Guidelines (FDG)
-* Fixed errors reported while running the Package Validation Suite
-
-## [1.6.0] - 2018-05-29
-
-* The fbxsdk package can now be used in standalone builds (runtime)
-
-## [1.5.0]
-
+* The Autodesk.Fbx assembly can now be used in standalone builds (runtime)
 * Added support for physical camera attributes
+* Added support for constraints: FbxConstraint, FbxConstraintParent, FbxConstraintAim, and related methods
+* Updated to FBX SDK 2018.1
 
-## [1.4.0]
-
-* First version accessible via Package Manager
-* Update to FBX SDK 2018.1.1
-* Add bindings for constraints: `FbxConstraint`, `FbxConstraintParent`, `FbxConstraintAim`, and related functions
-* Reduced binary size on Mac (which also shrinks the package for everyone)
-
-## [1.3.0a1]
-
-* Fix Universal Windows Platform build error caused by UnityFbxSdk.dll being set as compatible with any platform instead of editor only.
-* Add bindings for FbxAnimCurveFilterUnroll
-* Add binding for FbxGlobalSettings SetTimeMode to set frame rate
-
-## [1.2.0b1]
+KNOWN ISSUES
+* The FBX SDK C# Bindings package is not supported if you build using the IL2CPP backend.
 
-* Update version number
-* Replace meta files with meta files from release 1.0.0b1 for backwards compatibility
-* Expose bindings to set FbxNode's transformation inherit type
-* Add binding for FbxCamera's FieldOfView property
+## [1.3.0f1] - 2018-04-17
 
-## [1.0.0b1]
-
-* Enforce FbxSdk DLL only works with Unity 2017.1+
-
-## [0.0.14a]
-* Note: skipping some versions so that FbxSdk package version matches FbxExporter package version
+NEW FEATURES
+* Added bindings for FbxAnimCurveFilterUnroll
+* Added binding for FbxGlobalSettings SetTimeMode to set frame rate
+* Exposed bindings to set FbxNode's transformation inherit type
+* Added binding for FbxCamera's FieldOfView property
 * Added FbxObject::GetScene
-
-## [0.0.10a]
-
-* Added documentation of vector classes.
-* Added test to check that the FbxSdk DLL cannot be used without the Unity Editor (This is a legal requirement).
-* Improve build process so it is more robust.
-
-## [0.0.9a]
-
-* Set the Doxygen homepage to be README.txt instead of README.md
-* Rename namespace to `Unity.FbxSdk`
-* Rename `FbxSharp.dll` and `fbxsdk_csharp` libaries to `UnityFbxSdk.dll` and `UnityFbxSdkNative` respectively
-* Change documentation title to "Unity FBXSDK C# API Reference"
-* Package zip file containing Doxygen documentation
-* Update license in README to Autodesk license
-
-## [0.0.8a]
-
-* Updated LICENCSE.txt to include Autodesk license
-* Use .bundle on Mac instead of .so for shared libraries
-* Ship bindings as binaries without source
-
-## [0.0.7a]
-Note: skipping version 0.0.6a so that FbxSdk package version matches FbxExporter package version
-
-* Add bindings for FbxIOFileHeaderInfo. 
+* Added bindings for FbxIOFileHeaderInfo. 
 * Exposed mCreator and mFileVersion as read-only attributes.
-* Made it easier for performance tests to pass.
-
-## [0.0.5a]
 
-* Added Doxygen documentation generation for C# bindings.
+FIXES
+* Fix Universal Windows Platform build error caused by UnityFbxSdk.dll being set as compatible with any platform instead of editor only.
+* Enforced FbxSdk DLL only works with Unity 2017.1+
diff --git a/Packages/Documentation/com.unity.formats.fbx/Public/CHANGELOG.md b/Packages/Documentation/com.unity.formats.fbx/Public/CHANGELOG.md
@@ -11,9 +11,9 @@ NEW FEATURES
 * Now using FBX SDK version 2018.1
 * Streamlined the API public interface
 * Added support for exporting constraints
-* ConvertToPrefab: Add ability to convert an fbx or prefab asset from the Project view
-  * Right click on an fbx in the project view then select Convert to Linked Prefab to create a linked prefab asset for the fbx. It will not create an instance in the scene.
-  * Right click on a prefab in the project view and select Convert to Linked Prefab to export the prefab to an fbx file and link the existing prefab to the newly created fbx.
+* ConvertToPrefab: Add ability to convert an FBX or prefab asset from the Project view
+  * Right click on an FBX in the project view then select Convert to Linked Prefab to create a linked prefab asset for the FBX file. It will not create an instance in the scene.
+  * Right click on a prefab in the project view and select Convert to Linked Prefab to export the prefab to an FBX file and link the existing prefab to the newly created FBX.
 
 FIXES
 * Fixed skinned mesh bone update
@@ -22,7 +22,7 @@ FIXES
 
 KNOWN ISSUES
 * ConvertToPrefab: UI doesn't provide feedback about whether it will be converting an existing file or creating new files.
-  * When converting an existing FBX file, the fbx filename and fbx export options are ignored (but not greyed out).
+  * When converting an existing FBX file, the FBX filename and FBX export options are ignored (but not greyed out).
   * When converting an existing prefab, the prefab filename is ignored (but not greyed out)
 
 ## [1.3.0f1] - 2018-04-17
@@ -48,19 +48,32 @@ NEW FEATURES
 * Added Maya LT one button import/export
 * Added Camera export support 
 * Added 3ds Max one button import/export
-* Ability to export fbx files from Unity
-* Convert to linked prefab to create a prefab that auto-updates with the linked fbx
+* Ability to export FBX files from Unity
+* Convert to linked prefab to create a prefab that auto-updates with the linked FBX
 * Maya one button import/export
 
 FIXES
 * ConvertToPrefab: fix Mesh Collider not pointing to exported mesh after converting
 * FbxExporter: fix so "Compatible Naming" doesn't modify scene on export
 * FbxExporter: link materials to objects connected to mesh instances
-* FbxExporter: export meshes in model prefab instances as mesh instances in fbx
-* ConvertToPrefab: Don't re-export fbx model instances
+* FbxExporter: export meshes in model prefab instances as mesh instances in FBX
+* ConvertToPrefab: Don't re-export FBX model instances
 * FbxExportSettings: fix console error on Mac when clicking "Install Unity Integration"
 * FbxExporter: fix so animating spot angle in Unity animates cone angle in Maya (not penumbra)
 * FbxExporter: export correct rotation order (xyz) for euler rotation animations (previously would export as zxy)
 * Fix Universal Windows Platform build errors caused by UnityFbxSdk.dll being set as compatible with any platform instead of editor only.
 * Fix so Object references aren't lost when using Convert to Linked Prefab Instance
-* Fix Maya Integration dropdown not appearing in the Export Settings
+* Fix Maya Integration dropdown not appearing in the Export Settings
+
+KNOWN ISSUES
+* Cannot export animation only from 3ds Max
+* FbxExporter: animated skinned meshes must be in the bind pose on export (i.e. not being previewed in the Animation or Timeline windows, and the original rig's fbx must not contain animation)
+* FbxExporter: animated meshes in bone hierarchy are not supported
+* FbxExporter: for skinned meshes all bones must be descendants of the root bone
+* 3DIntegration: FBX containing rig must have file units in cm in order for animation exported from Unity to be properly applied
+* ConvertToPrefab: converting model instance that has been modified in the scene won't re-export FBX
+* Requires Unity 2018.1.0
+* When exporting with an animated transform for a Camera or a Light, the resulting rotation does not take the forward direction into account and is off by 90 degrees
+* Key tangents are not exported and the default key tangent setting is different between Unity, FBXSDK and Maya. This cause the curve shape to change between Unity and Maya.
+* Animated continuous rotations are not maintained
+* Animated rotations with Euler Angles (Quaternion) or Quaternion interpolation are not converted to the correct Euler equivalent.
