Document possible revision issue with old UIPs

Task-number: QT3DS-1835
Change-Id: I4a56e29383c0985549eae0b83f8f9cb48347a0ff
Reviewed-by: Miikka Heikkinen <miikka.heikkinen@qt.io>
Reviewed-by: Marianne Yrjänä <marianne.yrjana@qt.io>
Reviewed-by: Tomi Korpipää <tomi.korpipaa@qt.io>

2 files changed, 17 insertions, 0 deletions

diff --git a/doc/src/00-concepts.qdoc b/doc/src/00-concepts.qdoc
index bf8973ff..b2dfe452 100644
--- a/doc/src/00-concepts.qdoc
+++ b/doc/src/00-concepts.qdoc
@@ -132,4 +132,21 @@ variations within the presentation.
 \e{Learn more about slides in}
 \l{studio-slide-palette.html}{Slide Palette}.
 
+\section1 Known Issues
+
+\section2 Possible problems after automatic mesh optimization
+
+When loading a presentation made with an earlier version (2.0 beta2 or older) of Qt 3D Studio
+which has imported FBX or DAE models, you may see the following messagebox:
+
+\image {mesh_optimization.png}{Old presentation version}
+
+If your \b{imported} models are not visible in the Viewer after seeing the message, you need to
+edit your \c{*.uip} file(s) manually. Some older versions of Studio referenced meshes with revision
+number in the \c{*.uip} file, and that revision causes it to be missing in the scope of the
+Viewer.
+
+You'll need to find all occurrences of \c{.mesh#<revision_number>} from you \c{*.uip} and
+replace them with \c{.mesh}.
+
 */
diff --git a/doc/src/images/mesh_optimization.png b/doc/src/images/mesh_optimization.png
new file mode 100644
index 00000000..f06803ea
--- /dev/null
+++ b/doc/src/images/mesh_optimization.png