add docs

Author: dotnetprog

Guide-XrmToolBox.md

@@ -0,0 +1,57 @@
+# Dataverse Configuration Migration Tool For XrmToolBox
+
+This tool is a plugin for [XrmToolBox](https://www.xrmtoolbox.com/) which allows you to create a schema definition file for data export and data import between dataverse environments.
+
+This tool generates the schema definition file in the same format as the official tool from Microsoft: [Configuration Migration Tool](https://learn.microsoft.com/en-us/power-platform/alm/configure-and-deploy-tools)
+
+This tool was created to support more data types that the official tool does.
+## ⭐Key Features⭐
+✔️ Schema definition file for export/import 
+
+### Upcoming features 🔜
+🔜 Configuration Data Importation \
+🔜 Configuration Data Exportation  
+
+>**Note**:  Those features are available through the cli tool. More Info [here](https://github.com/dotnetprog/dataverse-configuration-migration-too)
+
+##  What's a schema definition file exactly 🤔❓
+
+A Schema definition file is an xml file that contains the definition of entities which contains the fields and the many to many relationships that you'd like to export/import between environments.
+
+## How to use the tool ?
+
+### Prerequisites
+- [.Net Framework 4.8 Runtime](https://dotnet.microsoft.com/en-us/download/dotnet-framework/net48)
+- [XrmToolBox](https://www.xrmtoolbox.com/)
+    - version must be atleast 1.2025.7.71
+
+### Getting Started
+
+> Make sure you have installed this package from the tool library in XrmToolBox: `Dataverse.ConfigurationMigrationTool.XrmToolBox`
+
+1. Open XrmToolBox
+2. Install `Dataverse.ConfigurationMigrationTool.XrmToolBox` from Tool Library if needed
+3. Open Tool : `Dataverse.ConfigurationMigrationTool.XrmToolBox`
+4. Connect to an environment
+
+### Create your schema file
+
+![tutorial](./images/ToolTutorial.png "tutorial")
+
+1. Load your solutions
+2. Select a solution
+3. Select an entity
+4. Select the fields and or relationships you want in your schema
+5. Click on the right arrow
+6. Click on the `Generate Schema File` and choose the location you want to save the file.
+
+> **Note:** You can add more fields and relations from other entities before generating your schema file.
+
+## Disclaimer
+
+Although this tool has the same name as the official configuration migration tool provided by Microsoft, it is not an official tool.
+
+It's a community homemade tool to offer an alternative with more features.
+
+
+

README.md

@@ -26,6 +26,7 @@ This new tool enables you to:
 :heavy_check_mark: Many to Many Relationships supported \
 :heavy_check_mark: Owner,Team And Business Unit field is now supported. If by Unique Id is not found in target env, it matches by name otherwise it ignores the field. Caching is used to avoid unnecessary calls to dataverse. \
 :heavy_check_mark: Supports schemas and data files generated from :
+- [Configuration Migration Tool for XrmToolBox](./Guide-XrmToolBox.md)
 - [PowerPlatform CLI Export](https://learn.microsoft.com/en-us/power-platform/developer/cli/reference/data#pac-data-export)
 - [Configuration Migration tool](https://learn.microsoft.com/en-us/power-platform/admin/create-schema-export-configuration-data)
 
@@ -111,6 +112,9 @@ You can use these workflows as a starting point for your own CI/CD automation. S
 
 ### </> Generating Schema and Data Files </>
 
+🆕 **You can now create your schema definition file from XrmToolBox using**  [Configuration Migration Tool for XrmToolBox](./Guide-XrmToolBox.md)🆕
+
+
 To use the `import` or `export-data` command, you need a schema file and/or a data file. These can be generated from your Dataverse environment using the official Configuration Migration tool. For detailed instructions, refer to the Microsoft documentation:
 
 - [Create a schema and export configuration data](https://learn.microsoft.com/en-us/power-platform/admin/create-schema-export-configuration-data)

images/ToolTutorial.png

@@ -4,9 +4,8 @@
     <version>1.0.0</version>
     <title>Configuration Migration Tool for XrmToolBox</title>
     <authors>François Desjardins-Nadeau</authors>
-    <owners>dotnetprog</owners>
     <projectUrl>https://github.com/dotnetprog/dataverse-configuration-migration-tool</projectUrl>
-    <iconUrl>https://github.com/dotnetprog/dataverse-configuration-migration-tool/blob/main/images/configurationmigrationtool_64.png?raw=true</iconUrl>
+    <icon>docs\images\configurationmigrationtool_64.png</icon>
     <requireLicenseAcceptance>false</requireLicenseAcceptance>
     <summary>Utility tool for migrating configuration data.</summary>
     <description>
@@ -17,12 +16,16 @@
       https://github.com/dotnetprog/dataverse-configuration-migration-tool/releases/latest
     </releaseNotes>
     <copyright>Copyright François Desjardins-Nadeau 2025</copyright>
-    <tags>XrmToolBox Plugins Dataverse ConfigurationMigrationTool data export import</tags>
+    <tags>XrmToolBox Dataverse ConfigurationMigrationTool data export import</tags>
     <dependencies>
       <dependency id="XrmToolBox" version="1.2025.7.71" />
     </dependencies>
+    <readme>docs\Guide-XrmToolBox.md</readme>
   </metadata>
   <files>
+    <file src="..\..\images\configurationmigrationtool_64.png" target="docs\images\" />
+    <file src="..\..\images\ToolTutorial.png" target="docs\images\" />
+    <file src="..\..\Guide-XrmToolBox.md" target="docs\" />
     <file src="Dataverse.ConfigurationMigrationTool.XrmToolBox\bin\Release\Dataverse.ConfigurationMigrationTool.XrmToolBox.dll" target="lib\net48\Plugins" />
   </files>
 </package>