Add a small PySide2 porting guide

Change-Id: Id030c46e56b24df02e8b946768c3deb1e09427a1
Reviewed-by: Cristian Maureira-Fredes <[email protected]>
Reviewed-by: Christian Tismer <[email protected]>

1 files changed, 29 insertions, 0 deletions

diff --git a/sources/pyside6/doc/porting_from2.rst b/sources/pyside6/doc/porting_from2.rst
new file mode 100644
index 000000000..c5ead6e05
--- /dev/null
+++ b/sources/pyside6/doc/porting_from2.rst
@@ -0,0 +1,29 @@
+Porting applications from PySide2 to PySide6
+********************************************
+
+Qt for Python 6.0.0 initially ships with the essential
+`Modules <https://doc.qt.io/qt-6/qtmodules.html>`_ and some
+add-ons (Qt Concurrent, Qt Help, Qt OpenGL, Qt Print Support
+Qt Quick Widgets, Qt SQL, Qt SVG, Qt UI Tools and Qt XML).
+More modules will follow in subsequent releases as they
+are added to Qt.
+
+The first thing to do when porting applications is to replace the
+import statements:
+
+::
+
+    from PySide2.QtWidgets import QApplication...
+    from PySide2 import QtCore
+
+needs to be changed to:
+
+::
+
+    from PySide6.QtWidgets import QApplication...
+    from PySide6 import QtCore
+
+Then, the code base needs to be checked for usage of deprecated API and adapted
+accordingly. More information can be found in the
+`Porting to Qt 6 <https://doc.qt.io/qt-6/portingguide.html>`_ Guide
+and the `Qt 6.0 Documentation <https://doc.qt.io/qt-6/index.html>`_ .