1 files changed, 44 insertions, 0 deletions
diff --git a/doc/migration-guide-6.3.qdoc b/doc/migration-guide-6.3.qdoc
new file mode 100644
index 00000000..6d70211e
--- /dev/null
+++ b/doc/migration-guide-6.3.qdoc
@@ -0,0 +1,44 @@
+/****************************************************************************
+**
+** Copyright (C) 2022 The Qt Company Ltd.
+** Contact: https://www.qt.io/licensing/
+**
+** This file is part of the documentation of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:FDL$
+** Commercial License Usage
+** Licensees holding valid commercial Qt licenses may use this file in
+** accordance with the commercial license agreement provided with the
+** Software or, alternatively, in accordance with the terms contained in
+** a written agreement between you and The Qt Company. For licensing terms
+** and conditions see https://www.qt.io/terms-conditions. For further
+** information use the contact form at https://www.qt.io/contact-us.
+**
+** GNU Free Documentation License Usage
+** Alternatively, this file may be used under the terms of the GNU Free
+** Documentation License version 1.3 as published by the Free Software
+** Foundation and appearing in the file included in the packaging of
+** this file. Please review the following information to ensure
+** the GNU Free Documentation License version 1.3 requirements
+** will be met: https://www.gnu.org/licenses/fdl-1.3.html.
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+/*!
+
+\page migration-guide-6.3.html
+\ingroup qtappman
+\ingroup qtappman-highlights
+\title Migrating code from 6.2 to 6.3
+\brief Discusses factors for moving from the 6.2 to the 6.3 release of the Application Manager.
+
+Qt Application Manager 6.3 cleaned up the APIs and manifest definitions concerning the Package,
+Application and Intent fields for \c icon, \c name and \c description.
+All three support the same API now, with the package's fields acting as a fallback for both the
+application and intent objects.
+Due to a clash between the property \c name and the function \c name in ApplicationObject,
+user code that called the \c{Application.name(language)} function before, now needs to replace
+this with \c{Application.names[language]}.
+
+*/