From 1463259b35831fd9a3a541ffe83574c501f9cde9 Mon Sep 17 00:00:00 2001
From: "Martin Hinshelwood nkdAgility.com" <martin@nkdagility.com>
Date: Tue, 24 Sep 2024 10:39:51 +0100
Subject: [PATCH] Updat docs

---
 .../TfsWorkItemMigrationProcessor-notes.md    |  10 +-
 ...ference.endpoints.azuredevopsendpoint.yaml |   3 +
 ....endpoints.filesystemworkitemendpoint.yaml |   3 +
 .../reference.endpoints.tfsendpoint.yaml      |   3 +
 ...ence.endpoints.tfsteamprojectendpoint.yaml |   3 +
 ...nce.endpoints.tfsteamsettingsendpoint.yaml |   3 +
 ...ference.endpoints.tfsworkitemendpoint.yaml |   3 +
 .../reference.fieldmaps.fieldclearmap.yaml    |   3 +
 .../reference.fieldmaps.fieldliteralmap.yaml  |   3 +
 .../reference.fieldmaps.fieldmergemap.yaml    |   3 +
 .../reference.fieldmaps.fieldskipmap.yaml     |   3 +
 .../reference.fieldmaps.fieldtofieldmap.yaml  |   3 +
 ...erence.fieldmaps.fieldtofieldmultimap.yaml |   3 +
 ...eference.fieldmaps.fieldtotagfieldmap.yaml |   3 +
 .../reference.fieldmaps.fieldvaluemap.yaml    |   3 +
 ...ce.fieldmaps.multivalueconditionalmap.yaml |   3 +
 .../reference.fieldmaps.regexfieldmap.yaml    |   3 +
 ...reference.fieldmaps.treetotagfieldmap.yaml |   3 +
 ...processorenrichers.pauseaftereachitem.yaml |   3 +
 ...ocessors.azuredevopspipelineprocessor.yaml |   3 +
 ...ssors.keepoutboundlinktargetprocessor.yaml |   5 +-
 ...cessors.outboundlinkcheckingprocessor.yaml |   3 +
 ...processors.processdefinitionprocessor.yaml |   3 +
 ...fsexportprofilepicturefromadprocessor.yaml |   3 +
 ...ors.tfsexportusersformappingprocessor.yaml |   3 +
 ...sors.tfsimportprofilepictureprocessor.yaml |   3 +
 ...ce.processors.tfssharedqueryprocessor.yaml |   3 +
 ...e.processors.tfsteamsettingsprocessor.yaml |   3 +
 ...stestconfigurationsmigrationprocessor.yaml |   3 +
 ...stestplansandsuitesmigrationprocessor.yaml |   3 +
 ...rs.tfstestvariablesmigrationprocessor.yaml |   3 +
 ...ocessors.tfsworkitembulkeditprocessor.yaml |   3 +
 ...processors.tfsworkitemdeleteprocessor.yaml |   3 +
 ...cessors.tfsworkitemmigrationprocessor.yaml |   3 +
 ...workitemoverwriteareasastagsprocessor.yaml |   3 +
 ...cessors.tfsworkitemoverwriteprocessor.yaml |   3 +
 ....processors.workitemtrackingprocessor.yaml |   3 +
 .../reference.tools.fieldmappingtool.yaml     |   3 +
 ...reference.tools.stringmanipulatortool.yaml |   3 +
 .../reference.tools.tfsattachmenttool.yaml    |   3 +
 ...ference.tools.tfschangesetmappingtool.yaml |   3 +
 .../reference.tools.tfsembededimagestool.yaml |   3 +
 .../reference.tools.tfsgitrepositorytool.yaml |   3 +
 .../reference.tools.tfsnodestructuretool.yaml |   3 +
 ...eference.tools.tfsrevisionmanagertool.yaml |   3 +
 .../reference.tools.tfsteamsettingstool.yaml  |   3 +
 .../reference.tools.tfsusermappingtool.yaml   |   3 +
 ...ce.tools.tfsvalidaterequiredfieldtool.yaml |   3 +
 ...ence.tools.tfsworkitemembededlinktool.yaml |   3 +
 .../reference.tools.tfsworkitemlinktool.yaml  |   3 +
 ...ference.tools.workitemtypemappingtool.yaml |   3 +
 docs/_layouts/reference.html                  |  17 ++-
 ...reference.endpoints.azuredevopsendpoint.md |   3 +
 ...ce.endpoints.filesystemworkitemendpoint.md |   3 +
 .../reference.endpoints.tfsendpoint.md        |   3 +
 ...erence.endpoints.tfsteamprojectendpoint.md |   3 +
 ...rence.endpoints.tfsteamsettingsendpoint.md |   3 +
 ...reference.endpoints.tfsworkitemendpoint.md |   3 +
 .../reference.fieldmaps.fieldclearmap.md      |   3 +
 .../reference.fieldmaps.fieldliteralmap.md    |   3 +
 .../reference.fieldmaps.fieldmergemap.md      |   3 +
 .../reference.fieldmaps.fieldskipmap.md       |   3 +
 .../reference.fieldmaps.fieldtofieldmap.md    |   3 +
 ...eference.fieldmaps.fieldtofieldmultimap.md |   3 +
 .../reference.fieldmaps.fieldtotagfieldmap.md |   3 +
 .../reference.fieldmaps.fieldvaluemap.md      |   3 +
 ...ence.fieldmaps.multivalueconditionalmap.md |   3 +
 .../reference.fieldmaps.regexfieldmap.md      |   3 +
 .../reference.fieldmaps.treetotagfieldmap.md  |   3 +
 ...e.processorenrichers.pauseaftereachitem.md |   3 +
 ...processors.azuredevopspipelineprocessor.md |   3 +
 ...cessors.keepoutboundlinktargetprocessor.md |   5 +-
 ...rocessors.outboundlinkcheckingprocessor.md |   3 +
 ...e.processors.processdefinitionprocessor.md |   3 +
 ....tfsexportprofilepicturefromadprocessor.md |   3 +
 ...ssors.tfsexportusersformappingprocessor.md |   3 +
 ...essors.tfsimportprofilepictureprocessor.md |   3 +
 ...ence.processors.tfssharedqueryprocessor.md |   3 +
 ...nce.processors.tfsteamsettingsprocessor.md |   3 +
 ...tfstestconfigurationsmigrationprocessor.md |   3 +
 ...tfstestplansandsuitesmigrationprocessor.md |  55 ++++++++-
 ...sors.tfstestvariablesmigrationprocessor.md |   3 +
 ...processors.tfsworkitembulkeditprocessor.md |   3 +
 ...e.processors.tfsworkitemdeleteprocessor.md |   3 +
 ...rocessors.tfsworkitemmigrationprocessor.md | 115 +++++++++++++++++-
 ...fsworkitemoverwriteareasastagsprocessor.md |   3 +
 ...rocessors.tfsworkitemoverwriteprocessor.md |   3 +
 ...ce.processors.workitemtrackingprocessor.md |   3 +
 .../reference.tools.fieldmappingtool.md       |   3 +
 .../reference.tools.stringmanipulatortool.md  |   3 +
 .../reference.tools.tfsattachmenttool.md      |   3 +
 ...reference.tools.tfschangesetmappingtool.md |   3 +
 .../reference.tools.tfsembededimagestool.md   |   3 +
 .../reference.tools.tfsgitrepositorytool.md   |   3 +
 .../reference.tools.tfsnodestructuretool.md   |   3 +
 .../reference.tools.tfsrevisionmanagertool.md |   3 +
 .../reference.tools.tfsteamsettingstool.md    |   3 +
 .../reference.tools.tfsusermappingtool.md     |   3 +
 ...ence.tools.tfsvalidaterequiredfieldtool.md |   3 +
 ...erence.tools.tfsworkitemembededlinktool.md |   3 +
 .../reference.tools.tfsworkitemlinktool.md    |   3 +
 ...reference.tools.workitemtypemappingtool.md |   3 +
 102 files changed, 478 insertions(+), 17 deletions(-)

diff --git a/docs/Reference/Processors/TfsWorkItemMigrationProcessor-notes.md b/docs/Reference/Processors/TfsWorkItemMigrationProcessor-notes.md
index a8709fb4a..d27b3094d 100644
--- a/docs/Reference/Processors/TfsWorkItemMigrationProcessor-notes.md
+++ b/docs/Reference/Processors/TfsWorkItemMigrationProcessor-notes.md
@@ -1,6 +1,6 @@
-## <a name="WIQLQueryBits"></a>WIQL Query Bits
+## <a name="WIQLQuery"></a>WIQL Query
 
-The Work Item queries are all built using Work Item [Query Language (WIQL)](https://docs.microsoft.com/en-us/azure/devops/boards/queries/wiql-syntax).
+The Work Item queries are all built using Work Item [Query Language (WIQL)](https://docs.microsoft.com/en-us/azure/devops/boards/queries/wiql-syntax). We only support flat quereis that have `FROM WorkItems` in the query.    
 
 > Note: A useful Azure DevOps Extension to explore WIQL is the [WIQL Editor](https://marketplace.visualstudio.com/items?itemName=ottostreifel.wiql-editor)
 
@@ -21,11 +21,11 @@ Scope to Area Path (Team data):
 
 ## <a name="NodeBasePath"></a>NodeBasePath Configuration 
 
-Moved to the ProcessorEnricher [TfsNodeStructure](/Reference/v2/ProcessorEnrichers/TfsNodeStructure/)
+Moved to the TfsNodeStructure
 
 # Iteration Maps and Area Maps
 
-Moved to the ProcessorEnricher [TfsNodeStructure](/Reference/v2/ProcessorEnrichers/TfsNodeStructure/)
+Moved to the TfsNodeStructure
 
 
 
@@ -34,7 +34,7 @@ The above options allow you to bring over a sub-set of the WIs (using the `WIQLQ
 
 Using the above sample structure, if you wanted to map the source project `Team 1`  to target project `Team A` etc. you could add the field map as follows
 
-A complete list of [FieldMaps](../Reference/v1/FieldMaps/index.md) are available.
+A complete list of [FieldMaps](../Reference/FieldMaps/index.md) are available.
 
 ```
  "FieldMaps": [
diff --git a/docs/_data/reference.endpoints.azuredevopsendpoint.yaml b/docs/_data/reference.endpoints.azuredevopsendpoint.yaml
index a2ef5f2af..a15680b5f 100644
--- a/docs/_data/reference.endpoints.azuredevopsendpoint.yaml
+++ b/docs/_data/reference.endpoints.azuredevopsendpoint.yaml
@@ -2,10 +2,12 @@ optionsClassName: AzureDevOpsEndpointOptions
 optionsClassFullName: MigrationTools.Endpoints.AzureDevOpsEndpointOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Endpoints.AzureDevOpsEndpointOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -25,6 +27,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Endpoints.AzureDevOpsEndpointOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.endpoints.filesystemworkitemendpoint.yaml b/docs/_data/reference.endpoints.filesystemworkitemendpoint.yaml
index 36372c2d4..ec2891dff 100644
--- a/docs/_data/reference.endpoints.filesystemworkitemendpoint.yaml
+++ b/docs/_data/reference.endpoints.filesystemworkitemendpoint.yaml
@@ -2,14 +2,17 @@ optionsClassName: FileSystemWorkItemEndpointOptions
 optionsClassFullName: MigrationTools.Endpoints.FileSystemWorkItemEndpointOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Endpoints.FileSystemWorkItemEndpointOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Endpoints.FileSystemWorkItemEndpointOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.endpoints.tfsendpoint.yaml b/docs/_data/reference.endpoints.tfsendpoint.yaml
index 19108a0a3..c97e736c0 100644
--- a/docs/_data/reference.endpoints.tfsendpoint.yaml
+++ b/docs/_data/reference.endpoints.tfsendpoint.yaml
@@ -2,6 +2,7 @@ optionsClassName: TfsEndpointOptions
 optionsClassFullName: MigrationTools.Endpoints.TfsEndpointOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -34,6 +35,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Endpoints.TfsEndpointOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -65,6 +67,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Endpoints.TfsEndpointOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.endpoints.tfsteamprojectendpoint.yaml b/docs/_data/reference.endpoints.tfsteamprojectendpoint.yaml
index 9e5d1aa6b..63e85bac1 100644
--- a/docs/_data/reference.endpoints.tfsteamprojectendpoint.yaml
+++ b/docs/_data/reference.endpoints.tfsteamprojectendpoint.yaml
@@ -2,6 +2,7 @@ optionsClassName: TfsTeamProjectEndpointOptions
 optionsClassFullName: MigrationTools.Endpoints.TfsTeamProjectEndpointOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -34,6 +35,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Endpoints.TfsTeamProjectEndpointOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -61,6 +63,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Endpoints.TfsTeamProjectEndpointOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.endpoints.tfsteamsettingsendpoint.yaml b/docs/_data/reference.endpoints.tfsteamsettingsendpoint.yaml
index f99a98bfc..c89d76353 100644
--- a/docs/_data/reference.endpoints.tfsteamsettingsendpoint.yaml
+++ b/docs/_data/reference.endpoints.tfsteamsettingsendpoint.yaml
@@ -2,14 +2,17 @@ optionsClassName: TfsTeamSettingsEndpointOptions
 optionsClassFullName: MigrationTools.Endpoints.TfsTeamSettingsEndpointOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Endpoints.TfsTeamSettingsEndpointOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Endpoints.TfsTeamSettingsEndpointOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.endpoints.tfsworkitemendpoint.yaml b/docs/_data/reference.endpoints.tfsworkitemendpoint.yaml
index 032221da0..f62426294 100644
--- a/docs/_data/reference.endpoints.tfsworkitemendpoint.yaml
+++ b/docs/_data/reference.endpoints.tfsworkitemendpoint.yaml
@@ -2,14 +2,17 @@ optionsClassName: TfsWorkItemEndpointOptions
 optionsClassFullName: MigrationTools.Endpoints.TfsWorkItemEndpointOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Endpoints.TfsWorkItemEndpointOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Endpoints.TfsWorkItemEndpointOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.fieldmaps.fieldclearmap.yaml b/docs/_data/reference.fieldmaps.fieldclearmap.yaml
index 8e394c728..c0dff37dd 100644
--- a/docs/_data/reference.fieldmaps.fieldclearmap.yaml
+++ b/docs/_data/reference.fieldmaps.fieldclearmap.yaml
@@ -2,6 +2,7 @@ optionsClassName: FieldClearMapOptions
 optionsClassFullName: MigrationTools.Tools.FieldClearMapOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -23,6 +24,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldClearMapOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -45,6 +47,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldClearMapOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.fieldmaps.fieldliteralmap.yaml b/docs/_data/reference.fieldmaps.fieldliteralmap.yaml
index e9698cec1..ff51f303d 100644
--- a/docs/_data/reference.fieldmaps.fieldliteralmap.yaml
+++ b/docs/_data/reference.fieldmaps.fieldliteralmap.yaml
@@ -2,6 +2,7 @@ optionsClassName: FieldLiteralMapOptions
 optionsClassFullName: MigrationTools.Tools.FieldLiteralMapOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -23,6 +24,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldLiteralMapOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -46,6 +48,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldLiteralMapOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.fieldmaps.fieldmergemap.yaml b/docs/_data/reference.fieldmaps.fieldmergemap.yaml
index 3ac96ea1d..667d8acca 100644
--- a/docs/_data/reference.fieldmaps.fieldmergemap.yaml
+++ b/docs/_data/reference.fieldmaps.fieldmergemap.yaml
@@ -2,6 +2,7 @@ optionsClassName: FieldMergeMapOptions
 optionsClassFullName: MigrationTools.Tools.FieldMergeMapOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -23,6 +24,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldMergeMapOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -50,6 +52,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldMergeMapOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.fieldmaps.fieldskipmap.yaml b/docs/_data/reference.fieldmaps.fieldskipmap.yaml
index 96d86aa6a..8230b2e7e 100644
--- a/docs/_data/reference.fieldmaps.fieldskipmap.yaml
+++ b/docs/_data/reference.fieldmaps.fieldskipmap.yaml
@@ -2,6 +2,7 @@ optionsClassName: FieldSkipMapOptions
 optionsClassFullName: MigrationTools.Tools.FieldSkipMapOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -23,10 +24,12 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldSkipMapOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Tools.FieldSkipMapOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.fieldmaps.fieldtofieldmap.yaml b/docs/_data/reference.fieldmaps.fieldtofieldmap.yaml
index 903aa8cb5..ac04009d9 100644
--- a/docs/_data/reference.fieldmaps.fieldtofieldmap.yaml
+++ b/docs/_data/reference.fieldmaps.fieldtofieldmap.yaml
@@ -2,6 +2,7 @@ optionsClassName: FieldToFieldMapOptions
 optionsClassFullName: MigrationTools.Tools.FieldToFieldMapOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -23,6 +24,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldToFieldMapOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -47,6 +49,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldToFieldMapOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.fieldmaps.fieldtofieldmultimap.yaml b/docs/_data/reference.fieldmaps.fieldtofieldmultimap.yaml
index 7a52ecbd8..b72af78d3 100644
--- a/docs/_data/reference.fieldmaps.fieldtofieldmultimap.yaml
+++ b/docs/_data/reference.fieldmaps.fieldtofieldmultimap.yaml
@@ -2,6 +2,7 @@ optionsClassName: FieldToFieldMultiMapOptions
 optionsClassFullName: MigrationTools.Tools.FieldToFieldMultiMapOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -23,6 +24,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldToFieldMultiMapOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -49,6 +51,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldToFieldMultiMapOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.fieldmaps.fieldtotagfieldmap.yaml b/docs/_data/reference.fieldmaps.fieldtotagfieldmap.yaml
index f703a4f92..705029e76 100644
--- a/docs/_data/reference.fieldmaps.fieldtotagfieldmap.yaml
+++ b/docs/_data/reference.fieldmaps.fieldtotagfieldmap.yaml
@@ -2,6 +2,7 @@ optionsClassName: FieldToTagFieldMapOptions
 optionsClassFullName: MigrationTools.Tools.FieldToTagFieldMapOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -23,6 +24,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldToTagFieldMapOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -50,6 +52,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldToTagFieldMapOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.fieldmaps.fieldvaluemap.yaml b/docs/_data/reference.fieldmaps.fieldvaluemap.yaml
index 6330529fd..10a839a45 100644
--- a/docs/_data/reference.fieldmaps.fieldvaluemap.yaml
+++ b/docs/_data/reference.fieldmaps.fieldvaluemap.yaml
@@ -2,6 +2,7 @@ optionsClassName: FieldValueMapOptions
 optionsClassFullName: MigrationTools.Tools.FieldValueMapOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -23,6 +24,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldValueMapOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -50,6 +52,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldValueMapOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.fieldmaps.multivalueconditionalmap.yaml b/docs/_data/reference.fieldmaps.multivalueconditionalmap.yaml
index d596b737c..0f8006cdd 100644
--- a/docs/_data/reference.fieldmaps.multivalueconditionalmap.yaml
+++ b/docs/_data/reference.fieldmaps.multivalueconditionalmap.yaml
@@ -2,6 +2,7 @@ optionsClassName: MultiValueConditionalMapOptions
 optionsClassFullName: MigrationTools.Tools.MultiValueConditionalMapOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -23,6 +24,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.MultiValueConditionalMapOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -52,6 +54,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.MultiValueConditionalMapOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.fieldmaps.regexfieldmap.yaml b/docs/_data/reference.fieldmaps.regexfieldmap.yaml
index e2ed7b018..d02593fd8 100644
--- a/docs/_data/reference.fieldmaps.regexfieldmap.yaml
+++ b/docs/_data/reference.fieldmaps.regexfieldmap.yaml
@@ -2,6 +2,7 @@ optionsClassName: RegexFieldMapOptions
 optionsClassFullName: MigrationTools.Tools.RegexFieldMapOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -23,6 +24,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.RegexFieldMapOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -48,6 +50,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.RegexFieldMapOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.fieldmaps.treetotagfieldmap.yaml b/docs/_data/reference.fieldmaps.treetotagfieldmap.yaml
index 533cbd093..13f1e6209 100644
--- a/docs/_data/reference.fieldmaps.treetotagfieldmap.yaml
+++ b/docs/_data/reference.fieldmaps.treetotagfieldmap.yaml
@@ -2,6 +2,7 @@ optionsClassName: TreeToTagFieldMapOptions
 optionsClassFullName: MigrationTools.Tools.TreeToTagFieldMapOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -23,10 +24,12 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TreeToTagFieldMapOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Tools.TreeToTagFieldMapOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.processorenrichers.pauseaftereachitem.yaml b/docs/_data/reference.processorenrichers.pauseaftereachitem.yaml
index 1cce83e27..0c418777f 100644
--- a/docs/_data/reference.processorenrichers.pauseaftereachitem.yaml
+++ b/docs/_data/reference.processorenrichers.pauseaftereachitem.yaml
@@ -2,14 +2,17 @@ optionsClassName: PauseAfterEachItemOptions
 optionsClassFullName: MigrationTools.Enrichers.PauseAfterEachItemOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Enrichers.PauseAfterEachItemOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Enrichers.PauseAfterEachItemOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.processors.azuredevopspipelineprocessor.yaml b/docs/_data/reference.processors.azuredevopspipelineprocessor.yaml
index 445d5ab54..3b81ceab9 100644
--- a/docs/_data/reference.processors.azuredevopspipelineprocessor.yaml
+++ b/docs/_data/reference.processors.azuredevopspipelineprocessor.yaml
@@ -2,6 +2,7 @@ optionsClassName: AzureDevOpsPipelineProcessorOptions
 optionsClassFullName: MigrationTools.Processors.AzureDevOpsPipelineProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -26,6 +27,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Processors.AzureDevOpsPipelineProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -50,6 +52,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Processors.AzureDevOpsPipelineProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.processors.keepoutboundlinktargetprocessor.yaml b/docs/_data/reference.processors.keepoutboundlinktargetprocessor.yaml
index 28ee83830..75fab3d20 100644
--- a/docs/_data/reference.processors.keepoutboundlinktargetprocessor.yaml
+++ b/docs/_data/reference.processors.keepoutboundlinktargetprocessor.yaml
@@ -2,14 +2,17 @@ optionsClassName: KeepOutboundLinkTargetProcessorOptions
 optionsClassFullName: MigrationTools.Clients.AzureDevops.Rest.Processors.KeepOutboundLinkTargetProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Clients.AzureDevops.Rest.Processors.KeepOutboundLinkTargetProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Clients.AzureDevops.Rest.Processors.KeepOutboundLinkTargetProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
@@ -17,7 +20,7 @@ configurationSamples:
       "Enabled": false,
       "WIQLQuery": "Select [System.Id] From WorkItems Where [System.TeamProject] = @project and not [System.WorkItemType] contains 'Test Suite, Test Plan,Shared Steps,Shared Parameter,Feedback Request'",
       "TargetLinksToKeepOrganization": "https://dev.azure.com/nkdagility",
-      "TargetLinksToKeepProject": "27ab4466-2eb2-45a0-abb3-6b3273112fe4",
+      "TargetLinksToKeepProject": "35537ca4-fac4-4fe6-8dd1-62e6c6a0684d",
       "CleanupFileName": "c:/temp/OutboundLinkTargets.bat",
       "PrependCommand": "start",
       "DryRun": true,
diff --git a/docs/_data/reference.processors.outboundlinkcheckingprocessor.yaml b/docs/_data/reference.processors.outboundlinkcheckingprocessor.yaml
index ab8ee6ecd..e6d9a98ef 100644
--- a/docs/_data/reference.processors.outboundlinkcheckingprocessor.yaml
+++ b/docs/_data/reference.processors.outboundlinkcheckingprocessor.yaml
@@ -2,14 +2,17 @@ optionsClassName: OutboundLinkCheckingProcessorOptions
 optionsClassFullName: MigrationTools.Clients.AzureDevops.Rest.Processors.OutboundLinkCheckingProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Clients.AzureDevops.Rest.Processors.OutboundLinkCheckingProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Clients.AzureDevops.Rest.Processors.OutboundLinkCheckingProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.processors.processdefinitionprocessor.yaml b/docs/_data/reference.processors.processdefinitionprocessor.yaml
index 650691d33..c9d5514a3 100644
--- a/docs/_data/reference.processors.processdefinitionprocessor.yaml
+++ b/docs/_data/reference.processors.processdefinitionprocessor.yaml
@@ -2,14 +2,17 @@ optionsClassName: ProcessDefinitionProcessorOptions
 optionsClassFullName: MigrationTools.Processors.ProcessDefinitionProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Processors.ProcessDefinitionProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Processors.ProcessDefinitionProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.processors.tfsexportprofilepicturefromadprocessor.yaml b/docs/_data/reference.processors.tfsexportprofilepicturefromadprocessor.yaml
index 3a411ce21..b9fb8df90 100644
--- a/docs/_data/reference.processors.tfsexportprofilepicturefromadprocessor.yaml
+++ b/docs/_data/reference.processors.tfsexportprofilepicturefromadprocessor.yaml
@@ -2,14 +2,17 @@ optionsClassName: TfsExportProfilePictureFromADProcessorOptions
 optionsClassFullName: MigrationTools.Processors.TfsExportProfilePictureFromADProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Processors.TfsExportProfilePictureFromADProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Processors.TfsExportProfilePictureFromADProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.processors.tfsexportusersformappingprocessor.yaml b/docs/_data/reference.processors.tfsexportusersformappingprocessor.yaml
index 75cc554fa..aa59d2d0c 100644
--- a/docs/_data/reference.processors.tfsexportusersformappingprocessor.yaml
+++ b/docs/_data/reference.processors.tfsexportusersformappingprocessor.yaml
@@ -2,14 +2,17 @@ optionsClassName: TfsExportUsersForMappingProcessorOptions
 optionsClassFullName: MigrationTools.Processors.TfsExportUsersForMappingProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Processors.TfsExportUsersForMappingProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Processors.TfsExportUsersForMappingProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.processors.tfsimportprofilepictureprocessor.yaml b/docs/_data/reference.processors.tfsimportprofilepictureprocessor.yaml
index 2b0407c73..2dfeb08d7 100644
--- a/docs/_data/reference.processors.tfsimportprofilepictureprocessor.yaml
+++ b/docs/_data/reference.processors.tfsimportprofilepictureprocessor.yaml
@@ -2,14 +2,17 @@ optionsClassName: TfsImportProfilePictureProcessorOptions
 optionsClassFullName: MigrationTools.Processors.TfsImportProfilePictureProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Processors.TfsImportProfilePictureProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Processors.TfsImportProfilePictureProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.processors.tfssharedqueryprocessor.yaml b/docs/_data/reference.processors.tfssharedqueryprocessor.yaml
index fa17acff3..69afccc25 100644
--- a/docs/_data/reference.processors.tfssharedqueryprocessor.yaml
+++ b/docs/_data/reference.processors.tfssharedqueryprocessor.yaml
@@ -2,14 +2,17 @@ optionsClassName: TfsSharedQueryProcessorOptions
 optionsClassFullName: MigrationTools.Processors.TfsSharedQueryProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Processors.TfsSharedQueryProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Processors.TfsSharedQueryProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.processors.tfsteamsettingsprocessor.yaml b/docs/_data/reference.processors.tfsteamsettingsprocessor.yaml
index ddbb18660..a9349bbbf 100644
--- a/docs/_data/reference.processors.tfsteamsettingsprocessor.yaml
+++ b/docs/_data/reference.processors.tfsteamsettingsprocessor.yaml
@@ -2,14 +2,17 @@ optionsClassName: TfsTeamSettingsProcessorOptions
 optionsClassFullName: MigrationTools.Processors.TfsTeamSettingsProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Processors.TfsTeamSettingsProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Processors.TfsTeamSettingsProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.processors.tfstestconfigurationsmigrationprocessor.yaml b/docs/_data/reference.processors.tfstestconfigurationsmigrationprocessor.yaml
index 9a8f6d2ba..968646c69 100644
--- a/docs/_data/reference.processors.tfstestconfigurationsmigrationprocessor.yaml
+++ b/docs/_data/reference.processors.tfstestconfigurationsmigrationprocessor.yaml
@@ -2,14 +2,17 @@ optionsClassName: TfsTestConfigurationsMigrationProcessorOptions
 optionsClassFullName: MigrationTools.Processors.TfsTestConfigurationsMigrationProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Processors.TfsTestConfigurationsMigrationProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Processors.TfsTestConfigurationsMigrationProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.processors.tfstestplansandsuitesmigrationprocessor.yaml b/docs/_data/reference.processors.tfstestplansandsuitesmigrationprocessor.yaml
index a6f9087e2..dce4cf7ab 100644
--- a/docs/_data/reference.processors.tfstestplansandsuitesmigrationprocessor.yaml
+++ b/docs/_data/reference.processors.tfstestplansandsuitesmigrationprocessor.yaml
@@ -2,14 +2,17 @@ optionsClassName: TfsTestPlansAndSuitesMigrationProcessorOptions
 optionsClassFullName: MigrationTools._EngineV1.Configuration.Processing.TfsTestPlansAndSuitesMigrationProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools._EngineV1.Configuration.Processing.TfsTestPlansAndSuitesMigrationProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools._EngineV1.Configuration.Processing.TfsTestPlansAndSuitesMigrationProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.processors.tfstestvariablesmigrationprocessor.yaml b/docs/_data/reference.processors.tfstestvariablesmigrationprocessor.yaml
index 3c2fb31c6..dbaefea61 100644
--- a/docs/_data/reference.processors.tfstestvariablesmigrationprocessor.yaml
+++ b/docs/_data/reference.processors.tfstestvariablesmigrationprocessor.yaml
@@ -2,14 +2,17 @@ optionsClassName: TfsTestVariablesMigrationProcessorOptions
 optionsClassFullName: MigrationTools.Processors.TfsTestVariablesMigrationProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Processors.TfsTestVariablesMigrationProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Processors.TfsTestVariablesMigrationProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.processors.tfsworkitembulkeditprocessor.yaml b/docs/_data/reference.processors.tfsworkitembulkeditprocessor.yaml
index 23853958e..d30978e8e 100644
--- a/docs/_data/reference.processors.tfsworkitembulkeditprocessor.yaml
+++ b/docs/_data/reference.processors.tfsworkitembulkeditprocessor.yaml
@@ -2,14 +2,17 @@ optionsClassName: TfsWorkItemBulkEditProcessorOptions
 optionsClassFullName: MigrationTools._EngineV1.Configuration.Processing.TfsWorkItemBulkEditProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools._EngineV1.Configuration.Processing.TfsWorkItemBulkEditProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools._EngineV1.Configuration.Processing.TfsWorkItemBulkEditProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.processors.tfsworkitemdeleteprocessor.yaml b/docs/_data/reference.processors.tfsworkitemdeleteprocessor.yaml
index 334fe6973..420afd6a4 100644
--- a/docs/_data/reference.processors.tfsworkitemdeleteprocessor.yaml
+++ b/docs/_data/reference.processors.tfsworkitemdeleteprocessor.yaml
@@ -2,14 +2,17 @@ optionsClassName: TfsWorkItemDeleteProcessorOptions
 optionsClassFullName: MigrationTools.Processors.TfsWorkItemDeleteProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Processors.TfsWorkItemDeleteProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Processors.TfsWorkItemDeleteProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.processors.tfsworkitemmigrationprocessor.yaml b/docs/_data/reference.processors.tfsworkitemmigrationprocessor.yaml
index 26ae7404b..54bc6067e 100644
--- a/docs/_data/reference.processors.tfsworkitemmigrationprocessor.yaml
+++ b/docs/_data/reference.processors.tfsworkitemmigrationprocessor.yaml
@@ -2,6 +2,7 @@ optionsClassName: TfsWorkItemMigrationProcessorOptions
 optionsClassFullName: MigrationTools.Processors.TfsWorkItemMigrationProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -32,6 +33,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Processors.TfsWorkItemMigrationProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -51,6 +53,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Processors.TfsWorkItemMigrationProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.processors.tfsworkitemoverwriteareasastagsprocessor.yaml b/docs/_data/reference.processors.tfsworkitemoverwriteareasastagsprocessor.yaml
index 3493957c0..a8009e4f7 100644
--- a/docs/_data/reference.processors.tfsworkitemoverwriteareasastagsprocessor.yaml
+++ b/docs/_data/reference.processors.tfsworkitemoverwriteareasastagsprocessor.yaml
@@ -2,14 +2,17 @@ optionsClassName: TfsWorkItemOverwriteAreasAsTagsProcessorOptions
 optionsClassFullName: MigrationTools.Processors.TfsWorkItemOverwriteAreasAsTagsProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Processors.TfsWorkItemOverwriteAreasAsTagsProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Processors.TfsWorkItemOverwriteAreasAsTagsProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.processors.tfsworkitemoverwriteprocessor.yaml b/docs/_data/reference.processors.tfsworkitemoverwriteprocessor.yaml
index 7f595e966..096b4abfe 100644
--- a/docs/_data/reference.processors.tfsworkitemoverwriteprocessor.yaml
+++ b/docs/_data/reference.processors.tfsworkitemoverwriteprocessor.yaml
@@ -2,14 +2,17 @@ optionsClassName: TfsWorkItemOverwriteProcessorOptions
 optionsClassFullName: MigrationTools.Processors.TfsWorkItemOverwriteProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Processors.TfsWorkItemOverwriteProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Processors.TfsWorkItemOverwriteProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.processors.workitemtrackingprocessor.yaml b/docs/_data/reference.processors.workitemtrackingprocessor.yaml
index 7ac13cf45..8d17cbf39 100644
--- a/docs/_data/reference.processors.workitemtrackingprocessor.yaml
+++ b/docs/_data/reference.processors.workitemtrackingprocessor.yaml
@@ -2,14 +2,17 @@ optionsClassName: WorkItemTrackingProcessorOptions
 optionsClassFullName: MigrationTools.Processors.WorkItemTrackingProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Processors.WorkItemTrackingProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Processors.WorkItemTrackingProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.tools.fieldmappingtool.yaml b/docs/_data/reference.tools.fieldmappingtool.yaml
index e159741e5..407ad565a 100644
--- a/docs/_data/reference.tools.fieldmappingtool.yaml
+++ b/docs/_data/reference.tools.fieldmappingtool.yaml
@@ -2,6 +2,7 @@ optionsClassName: FieldMappingToolOptions
 optionsClassFullName: MigrationTools.Tools.FieldMappingToolOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -22,6 +23,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldMappingToolOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -189,6 +191,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldMappingToolOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.tools.stringmanipulatortool.yaml b/docs/_data/reference.tools.stringmanipulatortool.yaml
index 222170f31..43ef13990 100644
--- a/docs/_data/reference.tools.stringmanipulatortool.yaml
+++ b/docs/_data/reference.tools.stringmanipulatortool.yaml
@@ -2,6 +2,7 @@ optionsClassName: StringManipulatorToolOptions
 optionsClassFullName: MigrationTools.Tools.StringManipulatorToolOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -26,6 +27,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.StringManipulatorToolOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -50,6 +52,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.StringManipulatorToolOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.tools.tfsattachmenttool.yaml b/docs/_data/reference.tools.tfsattachmenttool.yaml
index 0481a7309..5f63321fe 100644
--- a/docs/_data/reference.tools.tfsattachmenttool.yaml
+++ b/docs/_data/reference.tools.tfsattachmenttool.yaml
@@ -2,6 +2,7 @@ optionsClassName: TfsAttachmentToolOptions
 optionsClassFullName: MigrationTools.Tools.TfsAttachmentToolOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -19,6 +20,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsAttachmentToolOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -36,6 +38,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsAttachmentToolOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.tools.tfschangesetmappingtool.yaml b/docs/_data/reference.tools.tfschangesetmappingtool.yaml
index 6255630b4..cbfa4e7e6 100644
--- a/docs/_data/reference.tools.tfschangesetmappingtool.yaml
+++ b/docs/_data/reference.tools.tfschangesetmappingtool.yaml
@@ -2,6 +2,7 @@ optionsClassName: TfsChangeSetMappingToolOptions
 optionsClassFullName: MigrationTools.Tools.TfsChangeSetMappingToolOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -17,6 +18,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsChangeSetMappingToolOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -32,6 +34,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsChangeSetMappingToolOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.tools.tfsembededimagestool.yaml b/docs/_data/reference.tools.tfsembededimagestool.yaml
index 6dc25a720..cbe503c35 100644
--- a/docs/_data/reference.tools.tfsembededimagestool.yaml
+++ b/docs/_data/reference.tools.tfsembededimagestool.yaml
@@ -2,6 +2,7 @@ optionsClassName: TfsEmbededImagesToolOptions
 optionsClassFullName: MigrationTools.Tools.TfsEmbededImagesToolOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -16,6 +17,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsEmbededImagesToolOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -30,6 +32,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsEmbededImagesToolOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.tools.tfsgitrepositorytool.yaml b/docs/_data/reference.tools.tfsgitrepositorytool.yaml
index e012b62b8..bcc99f6cc 100644
--- a/docs/_data/reference.tools.tfsgitrepositorytool.yaml
+++ b/docs/_data/reference.tools.tfsgitrepositorytool.yaml
@@ -2,6 +2,7 @@ optionsClassName: TfsGitRepositoryToolOptions
 optionsClassFullName: MigrationTools.Tools.TfsGitRepositoryToolOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -17,6 +18,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsGitRepositoryToolOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -34,6 +36,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsGitRepositoryToolOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.tools.tfsnodestructuretool.yaml b/docs/_data/reference.tools.tfsnodestructuretool.yaml
index f91c9e7ba..e296195b1 100644
--- a/docs/_data/reference.tools.tfsnodestructuretool.yaml
+++ b/docs/_data/reference.tools.tfsnodestructuretool.yaml
@@ -2,6 +2,7 @@ optionsClassName: TfsNodeStructureToolOptions
 optionsClassFullName: MigrationTools.Tools.TfsNodeStructureToolOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -26,6 +27,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsNodeStructureToolOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -63,6 +65,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsNodeStructureToolOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.tools.tfsrevisionmanagertool.yaml b/docs/_data/reference.tools.tfsrevisionmanagertool.yaml
index a790c2861..034a1d10d 100644
--- a/docs/_data/reference.tools.tfsrevisionmanagertool.yaml
+++ b/docs/_data/reference.tools.tfsrevisionmanagertool.yaml
@@ -2,6 +2,7 @@ optionsClassName: TfsRevisionManagerToolOptions
 optionsClassFullName: MigrationTools.Tools.TfsRevisionManagerToolOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -18,6 +19,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsRevisionManagerToolOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -34,6 +36,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsRevisionManagerToolOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.tools.tfsteamsettingstool.yaml b/docs/_data/reference.tools.tfsteamsettingstool.yaml
index 77f6a1816..43b14db48 100644
--- a/docs/_data/reference.tools.tfsteamsettingstool.yaml
+++ b/docs/_data/reference.tools.tfsteamsettingstool.yaml
@@ -2,6 +2,7 @@ optionsClassName: TfsTeamSettingsToolOptions
 optionsClassFullName: MigrationTools.Tools.TfsTeamSettingsToolOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -20,6 +21,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsTeamSettingsToolOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -41,6 +43,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsTeamSettingsToolOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.tools.tfsusermappingtool.yaml b/docs/_data/reference.tools.tfsusermappingtool.yaml
index 26b9c9d8f..21e992a85 100644
--- a/docs/_data/reference.tools.tfsusermappingtool.yaml
+++ b/docs/_data/reference.tools.tfsusermappingtool.yaml
@@ -2,6 +2,7 @@ optionsClassName: TfsUserMappingToolOptions
 optionsClassFullName: MigrationTools.Tools.TfsUserMappingToolOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -25,6 +26,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsUserMappingToolOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -48,6 +50,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsUserMappingToolOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.tools.tfsvalidaterequiredfieldtool.yaml b/docs/_data/reference.tools.tfsvalidaterequiredfieldtool.yaml
index b7cd0840d..194b9de78 100644
--- a/docs/_data/reference.tools.tfsvalidaterequiredfieldtool.yaml
+++ b/docs/_data/reference.tools.tfsvalidaterequiredfieldtool.yaml
@@ -2,14 +2,17 @@ optionsClassName: TfsValidateRequiredFieldToolOptions
 optionsClassFullName: MigrationTools.Tools.TfsValidateRequiredFieldToolOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Tools.TfsValidateRequiredFieldToolOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Tools.TfsValidateRequiredFieldToolOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.tools.tfsworkitemembededlinktool.yaml b/docs/_data/reference.tools.tfsworkitemembededlinktool.yaml
index 119a80faa..2c06c3f3b 100644
--- a/docs/_data/reference.tools.tfsworkitemembededlinktool.yaml
+++ b/docs/_data/reference.tools.tfsworkitemembededlinktool.yaml
@@ -2,6 +2,7 @@ optionsClassName: TfsWorkItemEmbededLinkToolOptions
 optionsClassFullName: MigrationTools.Tools.TfsWorkItemEmbededLinkToolOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -16,6 +17,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsWorkItemEmbededLinkToolOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -30,6 +32,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsWorkItemEmbededLinkToolOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.tools.tfsworkitemlinktool.yaml b/docs/_data/reference.tools.tfsworkitemlinktool.yaml
index 2c8b790ef..7439af47e 100644
--- a/docs/_data/reference.tools.tfsworkitemlinktool.yaml
+++ b/docs/_data/reference.tools.tfsworkitemlinktool.yaml
@@ -2,6 +2,7 @@ optionsClassName: TfsWorkItemLinkToolOptions
 optionsClassFullName: MigrationTools.Tools.TfsWorkItemLinkToolOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -18,6 +19,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsWorkItemLinkToolOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -34,6 +36,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsWorkItemLinkToolOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_data/reference.tools.workitemtypemappingtool.yaml b/docs/_data/reference.tools.workitemtypemappingtool.yaml
index ced01edfa..74881e764 100644
--- a/docs/_data/reference.tools.workitemtypemappingtool.yaml
+++ b/docs/_data/reference.tools.workitemtypemappingtool.yaml
@@ -2,6 +2,7 @@ optionsClassName: WorkItemTypeMappingToolOptions
 optionsClassFullName: MigrationTools.Tools.WorkItemTypeMappingToolOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -19,6 +20,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.WorkItemTypeMappingToolOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -36,6 +38,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.WorkItemTypeMappingToolOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/_layouts/reference.html b/docs/_layouts/reference.html
index 433fd81d1..1ed1a58ee 100644
--- a/docs/_layouts/reference.html
+++ b/docs/_layouts/reference.html
@@ -42,18 +42,27 @@ <h2>Options</h2>
     </div>
 
     <h2>Examples</h2>
-    {% assign configurationSamples = page.configurationSamples %}
+    {% assign configurationSamples = page.configurationSamples | sort: "order" %}
     {% for sample in configurationSamples %}
     <h3>{{sample.name}}</h3>
-    {% if sample.name == "Classic" %}
-    <p>We have moved to a new config format, but are still tying to get this here to generate :)! The sample below is generated and is still valid for the settings, but you will need to map it to the main format.</p>
+    {% if sample.name == "classic" %}
+    <p>We have moved to a new config format, and you will need to update your old configs. This entry is a strate seralisation of the object and is here for legacy, and may provide value for debugging issues. </p>
+    {% endif %}
+    {% if sample.name == "defaults" %}
+    <p>These are the default values for this configuration. If you do not set it in your config the default always applies. You can overide by adding a diferent value in your config.</p>
+    {% endif %}
+    {% if sample.name == "sample" %}
+    <p>This is an example of what your config might look like once configured.</p>
     {% endif %}
     {% highlight json linenos %}
     {{sample.code}}
     {% endhighlight %}
     {% endfor %}
     {% assign mdInfo = page.topics | where: "topic", "notes" | last %}
-    <p>{{ mdInfo.markdown | markdownify }}</p>
+    {% capture processedContent %}
+    {{ mdInfo.markdown }}
+    {% endcapture %}
+    <p>{{ processedContent | markdownify }}</p>
 
     {{ content | inject_anchors }}
 
diff --git a/docs/collections/_reference/reference.endpoints.azuredevopsendpoint.md b/docs/collections/_reference/reference.endpoints.azuredevopsendpoint.md
index 8a05af650..f1a5a3b68 100644
--- a/docs/collections/_reference/reference.endpoints.azuredevopsendpoint.md
+++ b/docs/collections/_reference/reference.endpoints.azuredevopsendpoint.md
@@ -3,10 +3,12 @@ optionsClassName: AzureDevOpsEndpointOptions
 optionsClassFullName: MigrationTools.Endpoints.AzureDevOpsEndpointOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Endpoints.AzureDevOpsEndpointOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -26,6 +28,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Endpoints.AzureDevOpsEndpointOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.endpoints.filesystemworkitemendpoint.md b/docs/collections/_reference/reference.endpoints.filesystemworkitemendpoint.md
index 0e8927d86..1457e0dd2 100644
--- a/docs/collections/_reference/reference.endpoints.filesystemworkitemendpoint.md
+++ b/docs/collections/_reference/reference.endpoints.filesystemworkitemendpoint.md
@@ -3,14 +3,17 @@ optionsClassName: FileSystemWorkItemEndpointOptions
 optionsClassFullName: MigrationTools.Endpoints.FileSystemWorkItemEndpointOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Endpoints.FileSystemWorkItemEndpointOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Endpoints.FileSystemWorkItemEndpointOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.endpoints.tfsendpoint.md b/docs/collections/_reference/reference.endpoints.tfsendpoint.md
index 845e7b212..b876b9ce8 100644
--- a/docs/collections/_reference/reference.endpoints.tfsendpoint.md
+++ b/docs/collections/_reference/reference.endpoints.tfsendpoint.md
@@ -3,6 +3,7 @@ optionsClassName: TfsEndpointOptions
 optionsClassFullName: MigrationTools.Endpoints.TfsEndpointOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -35,6 +36,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Endpoints.TfsEndpointOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -66,6 +68,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Endpoints.TfsEndpointOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.endpoints.tfsteamprojectendpoint.md b/docs/collections/_reference/reference.endpoints.tfsteamprojectendpoint.md
index deaad76ec..fdfed068d 100644
--- a/docs/collections/_reference/reference.endpoints.tfsteamprojectendpoint.md
+++ b/docs/collections/_reference/reference.endpoints.tfsteamprojectendpoint.md
@@ -3,6 +3,7 @@ optionsClassName: TfsTeamProjectEndpointOptions
 optionsClassFullName: MigrationTools.Endpoints.TfsTeamProjectEndpointOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -35,6 +36,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Endpoints.TfsTeamProjectEndpointOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -62,6 +64,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Endpoints.TfsTeamProjectEndpointOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.endpoints.tfsteamsettingsendpoint.md b/docs/collections/_reference/reference.endpoints.tfsteamsettingsendpoint.md
index 579cae086..bd515631b 100644
--- a/docs/collections/_reference/reference.endpoints.tfsteamsettingsendpoint.md
+++ b/docs/collections/_reference/reference.endpoints.tfsteamsettingsendpoint.md
@@ -3,14 +3,17 @@ optionsClassName: TfsTeamSettingsEndpointOptions
 optionsClassFullName: MigrationTools.Endpoints.TfsTeamSettingsEndpointOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Endpoints.TfsTeamSettingsEndpointOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Endpoints.TfsTeamSettingsEndpointOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.endpoints.tfsworkitemendpoint.md b/docs/collections/_reference/reference.endpoints.tfsworkitemendpoint.md
index 4172e06e0..42f0848ce 100644
--- a/docs/collections/_reference/reference.endpoints.tfsworkitemendpoint.md
+++ b/docs/collections/_reference/reference.endpoints.tfsworkitemendpoint.md
@@ -3,14 +3,17 @@ optionsClassName: TfsWorkItemEndpointOptions
 optionsClassFullName: MigrationTools.Endpoints.TfsWorkItemEndpointOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Endpoints.TfsWorkItemEndpointOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Endpoints.TfsWorkItemEndpointOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.fieldmaps.fieldclearmap.md b/docs/collections/_reference/reference.fieldmaps.fieldclearmap.md
index 79b889cb1..105608355 100644
--- a/docs/collections/_reference/reference.fieldmaps.fieldclearmap.md
+++ b/docs/collections/_reference/reference.fieldmaps.fieldclearmap.md
@@ -3,6 +3,7 @@ optionsClassName: FieldClearMapOptions
 optionsClassFullName: MigrationTools.Tools.FieldClearMapOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -24,6 +25,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldClearMapOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -46,6 +48,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldClearMapOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.fieldmaps.fieldliteralmap.md b/docs/collections/_reference/reference.fieldmaps.fieldliteralmap.md
index dfda3b394..7fcdcc30f 100644
--- a/docs/collections/_reference/reference.fieldmaps.fieldliteralmap.md
+++ b/docs/collections/_reference/reference.fieldmaps.fieldliteralmap.md
@@ -3,6 +3,7 @@ optionsClassName: FieldLiteralMapOptions
 optionsClassFullName: MigrationTools.Tools.FieldLiteralMapOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -24,6 +25,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldLiteralMapOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -47,6 +49,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldLiteralMapOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.fieldmaps.fieldmergemap.md b/docs/collections/_reference/reference.fieldmaps.fieldmergemap.md
index 5407e5a88..82f3e9b30 100644
--- a/docs/collections/_reference/reference.fieldmaps.fieldmergemap.md
+++ b/docs/collections/_reference/reference.fieldmaps.fieldmergemap.md
@@ -3,6 +3,7 @@ optionsClassName: FieldMergeMapOptions
 optionsClassFullName: MigrationTools.Tools.FieldMergeMapOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -24,6 +25,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldMergeMapOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -51,6 +53,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldMergeMapOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.fieldmaps.fieldskipmap.md b/docs/collections/_reference/reference.fieldmaps.fieldskipmap.md
index 6e0cab679..4e3d84792 100644
--- a/docs/collections/_reference/reference.fieldmaps.fieldskipmap.md
+++ b/docs/collections/_reference/reference.fieldmaps.fieldskipmap.md
@@ -3,6 +3,7 @@ optionsClassName: FieldSkipMapOptions
 optionsClassFullName: MigrationTools.Tools.FieldSkipMapOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -24,10 +25,12 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldSkipMapOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Tools.FieldSkipMapOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.fieldmaps.fieldtofieldmap.md b/docs/collections/_reference/reference.fieldmaps.fieldtofieldmap.md
index c947391bc..af06378f9 100644
--- a/docs/collections/_reference/reference.fieldmaps.fieldtofieldmap.md
+++ b/docs/collections/_reference/reference.fieldmaps.fieldtofieldmap.md
@@ -3,6 +3,7 @@ optionsClassName: FieldToFieldMapOptions
 optionsClassFullName: MigrationTools.Tools.FieldToFieldMapOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -24,6 +25,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldToFieldMapOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -48,6 +50,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldToFieldMapOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.fieldmaps.fieldtofieldmultimap.md b/docs/collections/_reference/reference.fieldmaps.fieldtofieldmultimap.md
index 5184ca6a7..87fe4fb47 100644
--- a/docs/collections/_reference/reference.fieldmaps.fieldtofieldmultimap.md
+++ b/docs/collections/_reference/reference.fieldmaps.fieldtofieldmultimap.md
@@ -3,6 +3,7 @@ optionsClassName: FieldToFieldMultiMapOptions
 optionsClassFullName: MigrationTools.Tools.FieldToFieldMultiMapOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -24,6 +25,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldToFieldMultiMapOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -50,6 +52,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldToFieldMultiMapOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.fieldmaps.fieldtotagfieldmap.md b/docs/collections/_reference/reference.fieldmaps.fieldtotagfieldmap.md
index 60012f22b..bbaf965a6 100644
--- a/docs/collections/_reference/reference.fieldmaps.fieldtotagfieldmap.md
+++ b/docs/collections/_reference/reference.fieldmaps.fieldtotagfieldmap.md
@@ -3,6 +3,7 @@ optionsClassName: FieldToTagFieldMapOptions
 optionsClassFullName: MigrationTools.Tools.FieldToTagFieldMapOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -24,6 +25,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldToTagFieldMapOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -51,6 +53,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldToTagFieldMapOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.fieldmaps.fieldvaluemap.md b/docs/collections/_reference/reference.fieldmaps.fieldvaluemap.md
index c78ee6e09..42abcc1bd 100644
--- a/docs/collections/_reference/reference.fieldmaps.fieldvaluemap.md
+++ b/docs/collections/_reference/reference.fieldmaps.fieldvaluemap.md
@@ -3,6 +3,7 @@ optionsClassName: FieldValueMapOptions
 optionsClassFullName: MigrationTools.Tools.FieldValueMapOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -24,6 +25,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldValueMapOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -51,6 +53,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldValueMapOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.fieldmaps.multivalueconditionalmap.md b/docs/collections/_reference/reference.fieldmaps.multivalueconditionalmap.md
index b6b883297..40c263f06 100644
--- a/docs/collections/_reference/reference.fieldmaps.multivalueconditionalmap.md
+++ b/docs/collections/_reference/reference.fieldmaps.multivalueconditionalmap.md
@@ -3,6 +3,7 @@ optionsClassName: MultiValueConditionalMapOptions
 optionsClassFullName: MigrationTools.Tools.MultiValueConditionalMapOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -24,6 +25,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.MultiValueConditionalMapOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -53,6 +55,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.MultiValueConditionalMapOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.fieldmaps.regexfieldmap.md b/docs/collections/_reference/reference.fieldmaps.regexfieldmap.md
index 1e1a94753..84da66e9d 100644
--- a/docs/collections/_reference/reference.fieldmaps.regexfieldmap.md
+++ b/docs/collections/_reference/reference.fieldmaps.regexfieldmap.md
@@ -3,6 +3,7 @@ optionsClassName: RegexFieldMapOptions
 optionsClassFullName: MigrationTools.Tools.RegexFieldMapOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -24,6 +25,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.RegexFieldMapOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -49,6 +51,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.RegexFieldMapOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.fieldmaps.treetotagfieldmap.md b/docs/collections/_reference/reference.fieldmaps.treetotagfieldmap.md
index 9184da967..e5ada12d0 100644
--- a/docs/collections/_reference/reference.fieldmaps.treetotagfieldmap.md
+++ b/docs/collections/_reference/reference.fieldmaps.treetotagfieldmap.md
@@ -3,6 +3,7 @@ optionsClassName: TreeToTagFieldMapOptions
 optionsClassFullName: MigrationTools.Tools.TreeToTagFieldMapOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -24,10 +25,12 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TreeToTagFieldMapOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Tools.TreeToTagFieldMapOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.processorenrichers.pauseaftereachitem.md b/docs/collections/_reference/reference.processorenrichers.pauseaftereachitem.md
index 77042d75a..cfda69c2a 100644
--- a/docs/collections/_reference/reference.processorenrichers.pauseaftereachitem.md
+++ b/docs/collections/_reference/reference.processorenrichers.pauseaftereachitem.md
@@ -3,14 +3,17 @@ optionsClassName: PauseAfterEachItemOptions
 optionsClassFullName: MigrationTools.Enrichers.PauseAfterEachItemOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Enrichers.PauseAfterEachItemOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Enrichers.PauseAfterEachItemOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.processors.azuredevopspipelineprocessor.md b/docs/collections/_reference/reference.processors.azuredevopspipelineprocessor.md
index 499075ec1..913b61b90 100644
--- a/docs/collections/_reference/reference.processors.azuredevopspipelineprocessor.md
+++ b/docs/collections/_reference/reference.processors.azuredevopspipelineprocessor.md
@@ -3,6 +3,7 @@ optionsClassName: AzureDevOpsPipelineProcessorOptions
 optionsClassFullName: MigrationTools.Processors.AzureDevOpsPipelineProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -27,6 +28,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Processors.AzureDevOpsPipelineProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -51,6 +53,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Processors.AzureDevOpsPipelineProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.processors.keepoutboundlinktargetprocessor.md b/docs/collections/_reference/reference.processors.keepoutboundlinktargetprocessor.md
index 31d6a3669..9bf6d032b 100644
--- a/docs/collections/_reference/reference.processors.keepoutboundlinktargetprocessor.md
+++ b/docs/collections/_reference/reference.processors.keepoutboundlinktargetprocessor.md
@@ -3,14 +3,17 @@ optionsClassName: KeepOutboundLinkTargetProcessorOptions
 optionsClassFullName: MigrationTools.Clients.AzureDevops.Rest.Processors.KeepOutboundLinkTargetProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Clients.AzureDevops.Rest.Processors.KeepOutboundLinkTargetProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Clients.AzureDevops.Rest.Processors.KeepOutboundLinkTargetProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
@@ -18,7 +21,7 @@ configurationSamples:
       "Enabled": false,
       "WIQLQuery": "Select [System.Id] From WorkItems Where [System.TeamProject] = @project and not [System.WorkItemType] contains 'Test Suite, Test Plan,Shared Steps,Shared Parameter,Feedback Request'",
       "TargetLinksToKeepOrganization": "https://dev.azure.com/nkdagility",
-      "TargetLinksToKeepProject": "27ab4466-2eb2-45a0-abb3-6b3273112fe4",
+      "TargetLinksToKeepProject": "35537ca4-fac4-4fe6-8dd1-62e6c6a0684d",
       "CleanupFileName": "c:/temp/OutboundLinkTargets.bat",
       "PrependCommand": "start",
       "DryRun": true,
diff --git a/docs/collections/_reference/reference.processors.outboundlinkcheckingprocessor.md b/docs/collections/_reference/reference.processors.outboundlinkcheckingprocessor.md
index 9200b93a4..d2a5fdda0 100644
--- a/docs/collections/_reference/reference.processors.outboundlinkcheckingprocessor.md
+++ b/docs/collections/_reference/reference.processors.outboundlinkcheckingprocessor.md
@@ -3,14 +3,17 @@ optionsClassName: OutboundLinkCheckingProcessorOptions
 optionsClassFullName: MigrationTools.Clients.AzureDevops.Rest.Processors.OutboundLinkCheckingProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Clients.AzureDevops.Rest.Processors.OutboundLinkCheckingProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Clients.AzureDevops.Rest.Processors.OutboundLinkCheckingProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.processors.processdefinitionprocessor.md b/docs/collections/_reference/reference.processors.processdefinitionprocessor.md
index 52943a929..d499aaaf3 100644
--- a/docs/collections/_reference/reference.processors.processdefinitionprocessor.md
+++ b/docs/collections/_reference/reference.processors.processdefinitionprocessor.md
@@ -3,14 +3,17 @@ optionsClassName: ProcessDefinitionProcessorOptions
 optionsClassFullName: MigrationTools.Processors.ProcessDefinitionProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Processors.ProcessDefinitionProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Processors.ProcessDefinitionProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.processors.tfsexportprofilepicturefromadprocessor.md b/docs/collections/_reference/reference.processors.tfsexportprofilepicturefromadprocessor.md
index 277dc8fba..c494bd492 100644
--- a/docs/collections/_reference/reference.processors.tfsexportprofilepicturefromadprocessor.md
+++ b/docs/collections/_reference/reference.processors.tfsexportprofilepicturefromadprocessor.md
@@ -3,14 +3,17 @@ optionsClassName: TfsExportProfilePictureFromADProcessorOptions
 optionsClassFullName: MigrationTools.Processors.TfsExportProfilePictureFromADProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Processors.TfsExportProfilePictureFromADProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Processors.TfsExportProfilePictureFromADProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.processors.tfsexportusersformappingprocessor.md b/docs/collections/_reference/reference.processors.tfsexportusersformappingprocessor.md
index 0a792487a..291686e94 100644
--- a/docs/collections/_reference/reference.processors.tfsexportusersformappingprocessor.md
+++ b/docs/collections/_reference/reference.processors.tfsexportusersformappingprocessor.md
@@ -3,14 +3,17 @@ optionsClassName: TfsExportUsersForMappingProcessorOptions
 optionsClassFullName: MigrationTools.Processors.TfsExportUsersForMappingProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Processors.TfsExportUsersForMappingProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Processors.TfsExportUsersForMappingProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.processors.tfsimportprofilepictureprocessor.md b/docs/collections/_reference/reference.processors.tfsimportprofilepictureprocessor.md
index 2dc91c0f3..e803c8534 100644
--- a/docs/collections/_reference/reference.processors.tfsimportprofilepictureprocessor.md
+++ b/docs/collections/_reference/reference.processors.tfsimportprofilepictureprocessor.md
@@ -3,14 +3,17 @@ optionsClassName: TfsImportProfilePictureProcessorOptions
 optionsClassFullName: MigrationTools.Processors.TfsImportProfilePictureProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Processors.TfsImportProfilePictureProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Processors.TfsImportProfilePictureProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.processors.tfssharedqueryprocessor.md b/docs/collections/_reference/reference.processors.tfssharedqueryprocessor.md
index a093e7b29..3027b6cf3 100644
--- a/docs/collections/_reference/reference.processors.tfssharedqueryprocessor.md
+++ b/docs/collections/_reference/reference.processors.tfssharedqueryprocessor.md
@@ -3,14 +3,17 @@ optionsClassName: TfsSharedQueryProcessorOptions
 optionsClassFullName: MigrationTools.Processors.TfsSharedQueryProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Processors.TfsSharedQueryProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Processors.TfsSharedQueryProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.processors.tfsteamsettingsprocessor.md b/docs/collections/_reference/reference.processors.tfsteamsettingsprocessor.md
index 70471cf29..6332a9082 100644
--- a/docs/collections/_reference/reference.processors.tfsteamsettingsprocessor.md
+++ b/docs/collections/_reference/reference.processors.tfsteamsettingsprocessor.md
@@ -3,14 +3,17 @@ optionsClassName: TfsTeamSettingsProcessorOptions
 optionsClassFullName: MigrationTools.Processors.TfsTeamSettingsProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Processors.TfsTeamSettingsProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Processors.TfsTeamSettingsProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.processors.tfstestconfigurationsmigrationprocessor.md b/docs/collections/_reference/reference.processors.tfstestconfigurationsmigrationprocessor.md
index 211916315..d92d0b5f3 100644
--- a/docs/collections/_reference/reference.processors.tfstestconfigurationsmigrationprocessor.md
+++ b/docs/collections/_reference/reference.processors.tfstestconfigurationsmigrationprocessor.md
@@ -3,14 +3,17 @@ optionsClassName: TfsTestConfigurationsMigrationProcessorOptions
 optionsClassFullName: MigrationTools.Processors.TfsTestConfigurationsMigrationProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Processors.TfsTestConfigurationsMigrationProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Processors.TfsTestConfigurationsMigrationProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.processors.tfstestplansandsuitesmigrationprocessor.md b/docs/collections/_reference/reference.processors.tfstestplansandsuitesmigrationprocessor.md
index 31d19aef6..985fd2a1f 100644
--- a/docs/collections/_reference/reference.processors.tfstestplansandsuitesmigrationprocessor.md
+++ b/docs/collections/_reference/reference.processors.tfstestplansandsuitesmigrationprocessor.md
@@ -3,14 +3,17 @@ optionsClassName: TfsTestPlansAndSuitesMigrationProcessorOptions
 optionsClassFullName: MigrationTools._EngineV1.Configuration.Processing.TfsTestPlansAndSuitesMigrationProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools._EngineV1.Configuration.Processing.TfsTestPlansAndSuitesMigrationProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools._EngineV1.Configuration.Processing.TfsTestPlansAndSuitesMigrationProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
@@ -84,8 +87,56 @@ categories:
 topics:
 - topic: notes
   path: /docs/Reference/Processors/TfsTestPlansAndSuitesMigrationProcessor-notes.md
-  exists: false
-  markdown: ''
+  exists: true
+  markdown: >2-
+
+    ## Additional Samples & Info
+
+
+    To run a full plans and suits you should run the three processors in this order below.  `TestVariablesMigrationConfig` and `TestConfigurationsMigrationConfig` only need run once.
+
+
+    ```json
+
+    "Processors": [
+        {
+          "$type": "TestVariablesMigrationConfig",
+          "Enabled": false
+        },
+        {
+          "$type": "TestConfigurationsMigrationConfig",
+          "Enabled": true
+        },
+        {
+          "$type": "TestPlansAndSuitesMigrationConfig",
+          "Enabled": true,
+          "PrefixProjectToNodes": false,
+          "OnlyElementsWithTag": null,
+          "TestPlanQueryBit": null,
+          "RemoveAllLinks": false,
+          "MigrationDelay": 0,
+          "UseCommonNodeStructureEnricherConfig": false,
+          "NodeBasePaths": [],
+          "AreaMaps": null,
+          "IterationMaps": null,
+          "RemoveInvalidTestSuiteLinks": false,
+          "FilterCompleted": false
+        }
+    ]
+
+    ```
+
+    ## Known working TestPlanQueryBit filter fields names
+
+
+    `AreaPath`, `PlanName` and `PlanState`
+
+
+    ```json
+
+    "TestPlanQueryBit": "PlanName = 'ABC'"
+
+    ```
 - topic: introduction
   path: /docs/Reference/Processors/TfsTestPlansAndSuitesMigrationProcessor-introduction.md
   exists: false
diff --git a/docs/collections/_reference/reference.processors.tfstestvariablesmigrationprocessor.md b/docs/collections/_reference/reference.processors.tfstestvariablesmigrationprocessor.md
index ad56b60b4..d16ea39b3 100644
--- a/docs/collections/_reference/reference.processors.tfstestvariablesmigrationprocessor.md
+++ b/docs/collections/_reference/reference.processors.tfstestvariablesmigrationprocessor.md
@@ -3,14 +3,17 @@ optionsClassName: TfsTestVariablesMigrationProcessorOptions
 optionsClassFullName: MigrationTools.Processors.TfsTestVariablesMigrationProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Processors.TfsTestVariablesMigrationProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Processors.TfsTestVariablesMigrationProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.processors.tfsworkitembulkeditprocessor.md b/docs/collections/_reference/reference.processors.tfsworkitembulkeditprocessor.md
index 422c36431..1dd9239ea 100644
--- a/docs/collections/_reference/reference.processors.tfsworkitembulkeditprocessor.md
+++ b/docs/collections/_reference/reference.processors.tfsworkitembulkeditprocessor.md
@@ -3,14 +3,17 @@ optionsClassName: TfsWorkItemBulkEditProcessorOptions
 optionsClassFullName: MigrationTools._EngineV1.Configuration.Processing.TfsWorkItemBulkEditProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools._EngineV1.Configuration.Processing.TfsWorkItemBulkEditProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools._EngineV1.Configuration.Processing.TfsWorkItemBulkEditProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.processors.tfsworkitemdeleteprocessor.md b/docs/collections/_reference/reference.processors.tfsworkitemdeleteprocessor.md
index c4eb23097..fb8130034 100644
--- a/docs/collections/_reference/reference.processors.tfsworkitemdeleteprocessor.md
+++ b/docs/collections/_reference/reference.processors.tfsworkitemdeleteprocessor.md
@@ -3,14 +3,17 @@ optionsClassName: TfsWorkItemDeleteProcessorOptions
 optionsClassFullName: MigrationTools.Processors.TfsWorkItemDeleteProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Processors.TfsWorkItemDeleteProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Processors.TfsWorkItemDeleteProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.processors.tfsworkitemmigrationprocessor.md b/docs/collections/_reference/reference.processors.tfsworkitemmigrationprocessor.md
index fad3b284a..f25084647 100644
--- a/docs/collections/_reference/reference.processors.tfsworkitemmigrationprocessor.md
+++ b/docs/collections/_reference/reference.processors.tfsworkitemmigrationprocessor.md
@@ -3,6 +3,7 @@ optionsClassName: TfsWorkItemMigrationProcessorOptions
 optionsClassFullName: MigrationTools.Processors.TfsWorkItemMigrationProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -33,6 +34,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Processors.TfsWorkItemMigrationProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -52,6 +54,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Processors.TfsWorkItemMigrationProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
@@ -130,11 +133,115 @@ categories:
 topics:
 - topic: notes
   path: /docs/Reference/Processors/TfsWorkItemMigrationProcessor-notes.md
-  exists: false
-  markdown: ''
+  exists: true
+  markdown: >+
+    ## <a name="WIQLQuery"></a>WIQL Query
+
+
+    The Work Item queries are all built using Work Item [Query Language (WIQL)](https://docs.microsoft.com/en-us/azure/devops/boards/queries/wiql-syntax). We only support flat quereis that have `FROM WorkItems` in the query.    
+
+
+    > Note: A useful Azure DevOps Extension to explore WIQL is the [WIQL Editor](https://marketplace.visualstudio.com/items?itemName=ottostreifel.wiql-editor)
+
+
+    ### Examples
+
+
+    You can use the [WIQL Editor](https://marketplace.visualstudio.com/items?itemName=ottostreifel.wiql-editor) to craft a query in Azure DevOps.
+
+
+    A simple example config:
+
+
+    ```
+
+    "WIQLQuery": "SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan','Shared Steps','Shared Parameter','Feedback Request') ORDER BY [System.ChangedDate] desc"
+
+    ```
+
+    Scope to Area Path (Team data):
+
+
+    ```
+
+    "WIQLQuery": "SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.AreaPath] UNDER 'project\Team 1\' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan','Shared Steps','Shared Parameter','Feedback Request') ORDER BY [System.ChangedDate] desc"
+
+    ```
+
+
+    ## <a name="NodeBasePath"></a>NodeBasePath Configuration 
+
+
+    Moved to the TfsNodeStructure
+
+
+    # Iteration Maps and Area Maps
+
+
+    Moved to the TfsNodeStructure
+
+
+
+
+    ## More Complex Team Migrations
+
+    The above options allow you to bring over a sub-set of the WIs (using the `WIQLQueryBit`) and move their area or iteration path to a default location. However you may wish to do something more complex e.g. re-map the team structure. This can be done with addition of a `FieldMaps` block to configuration in addition to the `NodeBasePaths`.
+
+
+    Using the above sample structure, if you wanted to map the source project `Team 1`  to target project `Team A` etc. you could add the field map as follows
+
+
+    A complete list of [FieldMaps](../Reference/FieldMaps/index.md) are available.
+
+
+    ```
+     "FieldMaps": [
+       {
+          "$type": "FieldValueMapConfig",
+          "WorkItemTypeName": "*",
+          "sourceField": "System.AreaPath",
+          "targetField": "System.AreaPath",
+          "defaultValue": "TargetProg",
+          "valueMapping": {
+            "SampleProj\\Team 1": "TargetProg\\Team A",
+            "SampleProj\\Team 2": "TargetProg\\Team B"
+            "SampleProj\\Team 3": "TargetProg\\Team C"
+          }
+        },
+      ],
+
+    ```
+
+
+    > Note: This mappings could also be achieved with other forms of Field mapper e.g. `RegexFieldMapConfig`, but the value mapper as an example is easy to understand
+
+
+    # Removed Properties
+
+
+    - PrefixProjectToNodes - This option was removed in favour of the Area and Iteration Maps on [TfsNodeStructure](/Reference/v2/ProcessorEnrichers/TfsNodeStructure/)
 - topic: introduction
   path: /docs/Reference/Processors/TfsWorkItemMigrationProcessor-introduction.md
-  exists: false
-  markdown: ''
+  exists: true
+  markdown: >+
+    The `WorkItemMigrationContext` processor is used for migrating work items from one Azure DevOps instance to another. This encompasses a variety of activities:
+
+
+    1. **Transferring Work Items Between Instances**: The primary purpose of the processor is to transfer work items, including bugs, tasks, user stories, features, and more, from one Azure DevOps instance to another.
+
+
+    2. **Migrating Work Item History**: The processor can also replicate the entire revision history of work items, providing continuity and maintaining a record of changes.
+
+
+    3. **Migrating Attachments and Links**: The processor can transfer any attachments or links associated with work items. This includes both external links and internal links to other work items.
+
+
+    4. **Updating Metadata**: If configured, the processor can update the "Created Date" and "Created By" fields on migrated work items to match the original items in the source instance.
+
+
+    5. **Filtering Work Items**: The processor can be configured to only migrate certain work items based on their area or iteration paths.
+
+
+    Overall, the `WorkItemMigrationContext` processor is a comprehensive tool for transferring work items and their associated data and metadata between Azure DevOps instances. It should be used whenever there is a need to move work items between instances while preserving as much information as possible.
 
 ---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.processors.tfsworkitemoverwriteareasastagsprocessor.md b/docs/collections/_reference/reference.processors.tfsworkitemoverwriteareasastagsprocessor.md
index f90804522..b26bd86e8 100644
--- a/docs/collections/_reference/reference.processors.tfsworkitemoverwriteareasastagsprocessor.md
+++ b/docs/collections/_reference/reference.processors.tfsworkitemoverwriteareasastagsprocessor.md
@@ -3,14 +3,17 @@ optionsClassName: TfsWorkItemOverwriteAreasAsTagsProcessorOptions
 optionsClassFullName: MigrationTools.Processors.TfsWorkItemOverwriteAreasAsTagsProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Processors.TfsWorkItemOverwriteAreasAsTagsProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Processors.TfsWorkItemOverwriteAreasAsTagsProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.processors.tfsworkitemoverwriteprocessor.md b/docs/collections/_reference/reference.processors.tfsworkitemoverwriteprocessor.md
index d7e09fdff..2f0f651fa 100644
--- a/docs/collections/_reference/reference.processors.tfsworkitemoverwriteprocessor.md
+++ b/docs/collections/_reference/reference.processors.tfsworkitemoverwriteprocessor.md
@@ -3,14 +3,17 @@ optionsClassName: TfsWorkItemOverwriteProcessorOptions
 optionsClassFullName: MigrationTools.Processors.TfsWorkItemOverwriteProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Processors.TfsWorkItemOverwriteProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Processors.TfsWorkItemOverwriteProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.processors.workitemtrackingprocessor.md b/docs/collections/_reference/reference.processors.workitemtrackingprocessor.md
index f5beacbdb..4f968c072 100644
--- a/docs/collections/_reference/reference.processors.workitemtrackingprocessor.md
+++ b/docs/collections/_reference/reference.processors.workitemtrackingprocessor.md
@@ -3,14 +3,17 @@ optionsClassName: WorkItemTrackingProcessorOptions
 optionsClassFullName: MigrationTools.Processors.WorkItemTrackingProcessorOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Processors.WorkItemTrackingProcessorOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Processors.WorkItemTrackingProcessorOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.tools.fieldmappingtool.md b/docs/collections/_reference/reference.tools.fieldmappingtool.md
index e0ab712f2..b49db683f 100644
--- a/docs/collections/_reference/reference.tools.fieldmappingtool.md
+++ b/docs/collections/_reference/reference.tools.fieldmappingtool.md
@@ -3,6 +3,7 @@ optionsClassName: FieldMappingToolOptions
 optionsClassFullName: MigrationTools.Tools.FieldMappingToolOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -23,6 +24,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldMappingToolOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -190,6 +192,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.FieldMappingToolOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.tools.stringmanipulatortool.md b/docs/collections/_reference/reference.tools.stringmanipulatortool.md
index 070f32c1e..b837a3814 100644
--- a/docs/collections/_reference/reference.tools.stringmanipulatortool.md
+++ b/docs/collections/_reference/reference.tools.stringmanipulatortool.md
@@ -3,6 +3,7 @@ optionsClassName: StringManipulatorToolOptions
 optionsClassFullName: MigrationTools.Tools.StringManipulatorToolOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -27,6 +28,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.StringManipulatorToolOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -51,6 +53,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.StringManipulatorToolOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.tools.tfsattachmenttool.md b/docs/collections/_reference/reference.tools.tfsattachmenttool.md
index 04ff3d87f..42099a09a 100644
--- a/docs/collections/_reference/reference.tools.tfsattachmenttool.md
+++ b/docs/collections/_reference/reference.tools.tfsattachmenttool.md
@@ -3,6 +3,7 @@ optionsClassName: TfsAttachmentToolOptions
 optionsClassFullName: MigrationTools.Tools.TfsAttachmentToolOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -20,6 +21,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsAttachmentToolOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -37,6 +39,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsAttachmentToolOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.tools.tfschangesetmappingtool.md b/docs/collections/_reference/reference.tools.tfschangesetmappingtool.md
index 23488d03d..95b8ef3cd 100644
--- a/docs/collections/_reference/reference.tools.tfschangesetmappingtool.md
+++ b/docs/collections/_reference/reference.tools.tfschangesetmappingtool.md
@@ -3,6 +3,7 @@ optionsClassName: TfsChangeSetMappingToolOptions
 optionsClassFullName: MigrationTools.Tools.TfsChangeSetMappingToolOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -18,6 +19,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsChangeSetMappingToolOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -33,6 +35,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsChangeSetMappingToolOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.tools.tfsembededimagestool.md b/docs/collections/_reference/reference.tools.tfsembededimagestool.md
index ecc2fd1f3..4cc6d2221 100644
--- a/docs/collections/_reference/reference.tools.tfsembededimagestool.md
+++ b/docs/collections/_reference/reference.tools.tfsembededimagestool.md
@@ -3,6 +3,7 @@ optionsClassName: TfsEmbededImagesToolOptions
 optionsClassFullName: MigrationTools.Tools.TfsEmbededImagesToolOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -17,6 +18,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsEmbededImagesToolOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -31,6 +33,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsEmbededImagesToolOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.tools.tfsgitrepositorytool.md b/docs/collections/_reference/reference.tools.tfsgitrepositorytool.md
index aa2235c75..a745f98f6 100644
--- a/docs/collections/_reference/reference.tools.tfsgitrepositorytool.md
+++ b/docs/collections/_reference/reference.tools.tfsgitrepositorytool.md
@@ -3,6 +3,7 @@ optionsClassName: TfsGitRepositoryToolOptions
 optionsClassFullName: MigrationTools.Tools.TfsGitRepositoryToolOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -18,6 +19,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsGitRepositoryToolOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -35,6 +37,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsGitRepositoryToolOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.tools.tfsnodestructuretool.md b/docs/collections/_reference/reference.tools.tfsnodestructuretool.md
index a274babd8..1b971fc92 100644
--- a/docs/collections/_reference/reference.tools.tfsnodestructuretool.md
+++ b/docs/collections/_reference/reference.tools.tfsnodestructuretool.md
@@ -3,6 +3,7 @@ optionsClassName: TfsNodeStructureToolOptions
 optionsClassFullName: MigrationTools.Tools.TfsNodeStructureToolOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -27,6 +28,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsNodeStructureToolOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -64,6 +66,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsNodeStructureToolOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.tools.tfsrevisionmanagertool.md b/docs/collections/_reference/reference.tools.tfsrevisionmanagertool.md
index 8e6432a90..5c33f5264 100644
--- a/docs/collections/_reference/reference.tools.tfsrevisionmanagertool.md
+++ b/docs/collections/_reference/reference.tools.tfsrevisionmanagertool.md
@@ -3,6 +3,7 @@ optionsClassName: TfsRevisionManagerToolOptions
 optionsClassFullName: MigrationTools.Tools.TfsRevisionManagerToolOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -19,6 +20,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsRevisionManagerToolOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -35,6 +37,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsRevisionManagerToolOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.tools.tfsteamsettingstool.md b/docs/collections/_reference/reference.tools.tfsteamsettingstool.md
index f7719597f..24d698267 100644
--- a/docs/collections/_reference/reference.tools.tfsteamsettingstool.md
+++ b/docs/collections/_reference/reference.tools.tfsteamsettingstool.md
@@ -3,6 +3,7 @@ optionsClassName: TfsTeamSettingsToolOptions
 optionsClassFullName: MigrationTools.Tools.TfsTeamSettingsToolOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -21,6 +22,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsTeamSettingsToolOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -42,6 +44,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsTeamSettingsToolOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.tools.tfsusermappingtool.md b/docs/collections/_reference/reference.tools.tfsusermappingtool.md
index 5d73a461a..9745565ff 100644
--- a/docs/collections/_reference/reference.tools.tfsusermappingtool.md
+++ b/docs/collections/_reference/reference.tools.tfsusermappingtool.md
@@ -3,6 +3,7 @@ optionsClassName: TfsUserMappingToolOptions
 optionsClassFullName: MigrationTools.Tools.TfsUserMappingToolOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -26,6 +27,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsUserMappingToolOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -49,6 +51,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsUserMappingToolOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.tools.tfsvalidaterequiredfieldtool.md b/docs/collections/_reference/reference.tools.tfsvalidaterequiredfieldtool.md
index bcb6c0d52..6c202ce80 100644
--- a/docs/collections/_reference/reference.tools.tfsvalidaterequiredfieldtool.md
+++ b/docs/collections/_reference/reference.tools.tfsvalidaterequiredfieldtool.md
@@ -3,14 +3,17 @@ optionsClassName: TfsValidateRequiredFieldToolOptions
 optionsClassFullName: MigrationTools.Tools.TfsValidateRequiredFieldToolOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: There are no defaults! Check the sample for options!
   sampleFor: MigrationTools.Tools.TfsValidateRequiredFieldToolOptions
 - name: sample
+  order: 1
   description: 
   code: There is no sample, but you can check the classic below for a general feel.
   sampleFor: MigrationTools.Tools.TfsValidateRequiredFieldToolOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.tools.tfsworkitemembededlinktool.md b/docs/collections/_reference/reference.tools.tfsworkitemembededlinktool.md
index 1eb050288..38e4122d0 100644
--- a/docs/collections/_reference/reference.tools.tfsworkitemembededlinktool.md
+++ b/docs/collections/_reference/reference.tools.tfsworkitemembededlinktool.md
@@ -3,6 +3,7 @@ optionsClassName: TfsWorkItemEmbededLinkToolOptions
 optionsClassFullName: MigrationTools.Tools.TfsWorkItemEmbededLinkToolOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -17,6 +18,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsWorkItemEmbededLinkToolOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -31,6 +33,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsWorkItemEmbededLinkToolOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.tools.tfsworkitemlinktool.md b/docs/collections/_reference/reference.tools.tfsworkitemlinktool.md
index abfb7ced2..4b5ad2fc7 100644
--- a/docs/collections/_reference/reference.tools.tfsworkitemlinktool.md
+++ b/docs/collections/_reference/reference.tools.tfsworkitemlinktool.md
@@ -3,6 +3,7 @@ optionsClassName: TfsWorkItemLinkToolOptions
 optionsClassFullName: MigrationTools.Tools.TfsWorkItemLinkToolOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -19,6 +20,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsWorkItemLinkToolOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -35,6 +37,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.TfsWorkItemLinkToolOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {
diff --git a/docs/collections/_reference/reference.tools.workitemtypemappingtool.md b/docs/collections/_reference/reference.tools.workitemtypemappingtool.md
index 54ad0db00..88fae7ad2 100644
--- a/docs/collections/_reference/reference.tools.workitemtypemappingtool.md
+++ b/docs/collections/_reference/reference.tools.workitemtypemappingtool.md
@@ -3,6 +3,7 @@ optionsClassName: WorkItemTypeMappingToolOptions
 optionsClassFullName: MigrationTools.Tools.WorkItemTypeMappingToolOptions
 configurationSamples:
 - name: defaults
+  order: 2
   description: 
   code: >-
     {
@@ -20,6 +21,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.WorkItemTypeMappingToolOptions
 - name: sample
+  order: 1
   description: 
   code: >-
     {
@@ -37,6 +39,7 @@ configurationSamples:
     }
   sampleFor: MigrationTools.Tools.WorkItemTypeMappingToolOptions
 - name: classic
+  order: 3
   description: 
   code: >-
     {