📝 Ref: #126 migration guide is added.

Author: nazrulworld

HISTORY.rst

@@ -7,12 +7,12 @@ History
 
 New Feature
 
-- `FHIR version R5 <https://www.hl7.org/fhir/R5/resourcelist.html>`_ support has been added under root package.
+- Support for `FHIR version R5 <https://www.hl7.org/fhir/R5/resourcelist.html>`_ has been added under root package.
 
 
 Breaking
 
-- All root resources (FHIR version R4B) are moved under sub-package ``R4B``
+- All root resources (FHIR version R4B) are moved under sub-package ``R4B``. Have a look at the migration guide.
 
 
 6.5.0 (2023-01-01)

README.rst

@@ -56,7 +56,7 @@ FHIR® Version Info
 
 FHIR® (Release R5, version 5.0.0) is available as default. Also previous versions are available as Python sub-package
 (each release name string becomes sub-package name, i.e ``R4B`` ).
-From ``fhir.resources`` version 7.0.0; there no FHIR ``R4`` instead of ``R4B`` is available as sub-package.
+From ``fhir.resources`` version 7.0.0; there is no FHIR ``R4`` instead of ``R4B`` is available as sub-package.
 
 **Available Previous Versions**:
 
@@ -700,6 +700,19 @@ We suggest you to try make a plan to be upgraded to R4B. Here you could find rel
 
 You could find full discussion here https://github.com/nazrulworld/fhir.resources/discussions/116
 
+Migration (from ``6.X.X`` to ``7.0.0``)
+---------------------------------------
+
+First of all, you have to correct all imports path, if you wish to keep continue using FHIR release R4B as those resources
+are moved under sub-package named ``R4B``. So if you wish to use current ``R5`` release,
+read carefully the following documents.
+
+    1. See the full changes history -> https://build.fhir.org/history.html
+    2. See complete lists of differences between R5 and R4B -> https://hl7.org/fhir/R5/diff.html
+    3. If you are planning to migrate direct from the release ``R4``,
+       then it is important to look at the differences between R4B and R4 here -> https://hl7.org/fhir/R4B/diff.html
+
+
 Migration (from later than ``6.X.X``)
 -------------------------------------