Fix for missing docs options (#2912)

This pull request introduces updates to various YAML configuration files
to add new parameters, improve documentation, and enhance functionality
for endpoints, field maps, and processors. The changes primarily focus
on adding an `Enabled` parameter across multiple configurations to
control feature activation, introducing additional enrichers, and
improving descriptions for better clarity.

### Enhancements to Endpoint Configurations:
* Added `Enabled`, `EndpointEnrichers`, and `Name` parameters to Azure
DevOps, TFS, and FileSystem endpoint configurations, enabling feature
toggling and enrichment capabilities.
(`reference.endpoints.azuredevopsendpoint.yaml` -
[[1]](diffhunk://#diff-bc9c953c9458eac6fc4ff921e430a106cbee9a8a0b87310a9df637789636bf1dR54-R65)
`reference.endpoints.tfsendpoint.yaml` -
[[2]](diffhunk://#diff-1b65e7ad11e417a8638f7ccda9f90feb4c400542ba71f54ae77030ce20b383d6R109-R124)
`reference.endpoints.filesystemworkitemendpoint.yaml` -
[[3]](diffhunk://#diff-7639b5b7487671377a9686b6e43e2191b00b20d8cf193becf13e585b35c4801dR27-R42)
* Introduced `AllowCrossProjectLinking` parameter in TFS-related
endpoints to allow or restrict linking across projects.
(`reference.endpoints.tfsendpoint.yaml` -
[[1]](diffhunk://#diff-1b65e7ad11e417a8638f7ccda9f90feb4c400542ba71f54ae77030ce20b383d6R97-R100)
`reference.endpoints.tfsteamprojectendpoint.yaml` -
[[2]](diffhunk://#diff-298ed9f2cb74a86ed0214311effa01a9f8cecd84e062261b832744f68599e282R93-R96)
`reference.endpoints.tfsteamsettingsendpoint.yaml` -
[[3]](diffhunk://#diff-5bf4ba0d1a55b31d78d862ef25bf3ad64f65e81c38f8280c8b2d13e373bf4d22R34-R37)
`reference.endpoints.tfsworkitemendpoint.yaml` -
[[4]](diffhunk://#diff-b1f465cdd3e8a1c7ce0907028b191384e1895af0e81590fc33077dbd8a59c799R35-R38)

### Updates to Field Map Configurations:
* Added an `Enabled` parameter to all field map configurations to allow
toggling of individual field map processing.
(`reference.fieldmaps.fieldcalculationmap.yaml` -
[[1]](diffhunk://#diff-ea275752251d020bb9679c0048016f3ee0a8884c2fc29ed5a00d143e97aba1eeR82-R85)
`reference.fieldmaps.fieldclearmap.yaml` -
[[2]](diffhunk://#diff-ceae921768fd50c4e2b8ec98685858f3558740891fe0aecb784a1bb37a83ccd5R70-R73)
`reference.fieldmaps.fieldliteralmap.yaml` -
[[3]](diffhunk://#diff-d8e9fd6af21d783da862272618dba89bcfe12f05ee1fe0f6202deb31821153e7R72-R75)
`reference.fieldmaps.fieldmergemap.yaml` -
[[4]](diffhunk://#diff-cea0caff29736cb6a9667f1c9cf7d6e17821e40ef85bbfd80e51d41d268c72d7R80-R83)
`reference.fieldmaps.fieldskipmap.yaml` -
[[5]](diffhunk://#diff-03967d69021b21c411e398ad32c4e07ade7c1947a2ddccce72a354653e14db82R51-R54)
`reference.fieldmaps.fieldtofieldmap.yaml` -
[[6]](diffhunk://#diff-996da70e5724b7d991c1ad90fe0dc3d90658e67c22b3f787a8e5f3798ca2c507R78-R81)
`reference.fieldmaps.fieldtofieldmultimap.yaml` -
[[7]](diffhunk://#diff-707edd0b9bc5a18cc07270f76ba0cbaad9393c7458fad46431d5ba0905d2e26dR78-R81)
`reference.fieldmaps.fieldtotagfieldmap.yaml` -
[[8]](diffhunk://#diff-ffec0f60e5ed248c812034b2d27db48f2950ff64714f3809d9d0e30bacbf53d5R76-R79)
`reference.fieldmaps.fieldvaluemap.yaml` -
[[9]](diffhunk://#diff-fba9f9560655c90dd8b9f09d28c6062047215daf497e13908650884428e11cd4R84-R87)
`reference.fieldmaps.multivalueconditionalmap.yaml` -
[[10]](diffhunk://#diff-adbf198aa43350840b2c0b7e0473a1dad26a984d7648acf09fed78a174d15420R84-R87)
`reference.fieldmaps.regexfieldmap.yaml` -
[[11]](diffhunk://#diff-3df481ee503cc8f0ee5404984aa8de566658c03ca67abed8e555f959317cae69R76-R79)
`reference.fieldmaps.treetotagfieldmap.yaml` -
[[12]](diffhunk://#diff-f95de04597babfa52e56041612f070b47752e46b57bab47e9b45dbaae8735028R52-R55)

### Processor Configuration Improvements:
* Added `Enrichers` parameter to the Azure DevOps Pipeline Processor
configuration to support additional features through enrichers.
(`reference.processors.azuredevopspipelineprocessor.yaml` -
[docs/data/classes/reference.processors.azuredevopspipelineprocessor.yamlR85-R88](diffhunk://#diff-61e29f3c4067e874ada1a44bad8b08d6c570f9e82990187da2403d3917f746d3R85-R88))
* Removed unused `OptionFor` parameter from the Pause After Each Item
processor configuration.
(`reference.processorenrichers.pauseaftereachitem.yaml` -
[docs/data/classes/reference.processorenrichers.pauseaftereachitem.yamlL33-L36](diffhunk://#diff-22d82f2df5cce55819c4a360fade15e05dd156184d282d98ded9d33c7d254860L33-L36))

These changes enhance configurability, improve documentation, and
streamline feature management across the project.

Author: MrHinsh

docs/data/classes/reference.endpoints.azuredevopsendpoint.yaml

@@ -51,6 +51,18 @@ options:
   type: AuthenticationMode
   description: Authentication mode to use when connecting to Azure DevOps. Typically uses AccessToken for modern Azure DevOps organizations.
   defaultValue: missing XML code comments
+- parameterName: Enabled
+  type: Boolean
+  description: Will be used if enabled
+  defaultValue: missing XML code comments
+- parameterName: EndpointEnrichers
+  type: List
+  description: missing XML code comments
+  defaultValue: missing XML code comments
+- parameterName: Name
+  type: String
+  description: missing XML code comments
+  defaultValue: missing XML code comments
 - parameterName: Organisation
   type: String
   description: URL of the Azure DevOps organization (e.g., "https://dev.azure.com/myorganization/"). Must include the full organization URL.

docs/data/classes/reference.endpoints.filesystemworkitemendpoint.yaml

@@ -24,10 +24,22 @@ description: missing XML code comments
 className: FileSystemWorkItemEndpoint
 typeName: Endpoints
 options:
+- parameterName: Enabled
+  type: Boolean
+  description: Will be used if enabled
+  defaultValue: missing XML code comments
+- parameterName: EndpointEnrichers
+  type: List
+  description: missing XML code comments
+  defaultValue: missing XML code comments
 - parameterName: FileStore
   type: String
   description: Path to the directory where work item data will be stored or read from. This should be a valid local file system path with appropriate read/write permissions.
   defaultValue: missing XML code comments
+- parameterName: Name
+  type: String
+  description: missing XML code comments
+  defaultValue: missing XML code comments
 status: missing XML code comments
 processingTarget: missing XML code comments
 classFile: src/MigrationTools.Clients.FileSystem/Endpoints/FileSystemWorkItemEndpoint.cs

docs/data/classes/reference.endpoints.tfsendpoint.yaml

@@ -94,6 +94,10 @@ description: missing XML code comments
 className: TfsEndpoint
 typeName: Endpoints
 options:
+- parameterName: AllowCrossProjectLinking
+  type: Boolean
+  description: When true, allows work items to link to items in different projects within the same collection. Default is false for security and organizational clarity.
+  defaultValue: missing XML code comments
 - parameterName: Authentication
   type: TfsAuthenticationOptions
   description: Authentication configuration for connecting to the TFS server. Supports various authentication modes including Windows authentication and access tokens.
@@ -102,10 +106,22 @@ options:
   type: Uri
   description: URI of the TFS collection (e.g., "http://tfsserver:8080/tfs/DefaultCollection"). Must be a valid absolute URL pointing to the TFS collection.
   defaultValue: missing XML code comments
+- parameterName: Enabled
+  type: Boolean
+  description: Will be used if enabled
+  defaultValue: missing XML code comments
+- parameterName: EndpointEnrichers
+  type: List
+  description: missing XML code comments
+  defaultValue: missing XML code comments
 - parameterName: LanguageMaps
   type: TfsLanguageMapOptions
   description: Language mapping configuration for translating area and iteration path names between different language versions of TFS.
   defaultValue: missing XML code comments
+- parameterName: Name
+  type: String
+  description: missing XML code comments
+  defaultValue: missing XML code comments
 - parameterName: Project
   type: String
   description: Name of the TFS project within the collection to connect to. This is the project that will be used for migration operations.

docs/data/classes/reference.endpoints.tfsteamprojectendpoint.yaml

@@ -90,6 +90,10 @@ description: missing XML code comments
 className: TfsTeamProjectEndpoint
 typeName: Endpoints
 options:
+- parameterName: AllowCrossProjectLinking
+  type: Boolean
+  description: When true, allows work items to link to items in different projects within the same collection. Default is false for security and organizational clarity.
+  defaultValue: missing XML code comments
 - parameterName: Authentication
   type: TfsAuthenticationOptions
   description: Authentication configuration for connecting to the TFS server. Supports various authentication modes including Windows authentication and access tokens.
@@ -98,10 +102,22 @@ options:
   type: Uri
   description: URI of the TFS collection (e.g., "http://tfsserver:8080/tfs/DefaultCollection"). Must be a valid absolute URL pointing to the TFS collection.
   defaultValue: missing XML code comments
+- parameterName: Enabled
+  type: Boolean
+  description: Will be used if enabled
+  defaultValue: missing XML code comments
+- parameterName: EndpointEnrichers
+  type: List
+  description: missing XML code comments
+  defaultValue: missing XML code comments
 - parameterName: LanguageMaps
   type: TfsLanguageMapOptions
   description: Language mapping configuration for translating area and iteration path names between different language versions of TFS.
   defaultValue: missing XML code comments
+- parameterName: Name
+  type: String
+  description: missing XML code comments
+  defaultValue: missing XML code comments
 - parameterName: Project
   type: String
   description: Name of the TFS project within the collection to connect to. This is the project that will be used for migration operations.

docs/data/classes/reference.endpoints.tfsteamsettingsendpoint.yaml

@@ -31,6 +31,10 @@ description: missing XML code comments
 className: TfsTeamSettingsEndpoint
 typeName: Endpoints
 options:
+- parameterName: AllowCrossProjectLinking
+  type: Boolean
+  description: When true, allows work items to link to items in different projects within the same collection. Default is false for security and organizational clarity.
+  defaultValue: missing XML code comments
 - parameterName: Authentication
   type: TfsAuthenticationOptions
   description: Authentication configuration for connecting to the TFS server. Supports various authentication modes including Windows authentication and access tokens.
@@ -39,10 +43,22 @@ options:
   type: Uri
   description: URI of the TFS collection (e.g., "http://tfsserver:8080/tfs/DefaultCollection"). Must be a valid absolute URL pointing to the TFS collection.
   defaultValue: missing XML code comments
+- parameterName: Enabled
+  type: Boolean
+  description: Will be used if enabled
+  defaultValue: missing XML code comments
+- parameterName: EndpointEnrichers
+  type: List
+  description: missing XML code comments
+  defaultValue: missing XML code comments
 - parameterName: LanguageMaps
   type: TfsLanguageMapOptions
   description: Language mapping configuration for translating area and iteration path names between different language versions of TFS.
   defaultValue: missing XML code comments
+- parameterName: Name
+  type: String
+  description: missing XML code comments
+  defaultValue: missing XML code comments
 - parameterName: Project
   type: String
   description: Name of the TFS project within the collection to connect to. This is the project that will be used for migration operations.

docs/data/classes/reference.endpoints.tfsworkitemendpoint.yaml

@@ -32,6 +32,10 @@ description: missing XML code comments
 className: TfsWorkItemEndpoint
 typeName: Endpoints
 options:
+- parameterName: AllowCrossProjectLinking
+  type: Boolean
+  description: When true, allows work items to link to items in different projects within the same collection. Default is false for security and organizational clarity.
+  defaultValue: missing XML code comments
 - parameterName: Authentication
   type: TfsAuthenticationOptions
   description: Authentication configuration for connecting to the TFS server. Supports various authentication modes including Windows authentication and access tokens.
@@ -40,10 +44,22 @@ options:
   type: Uri
   description: URI of the TFS collection (e.g., "http://tfsserver:8080/tfs/DefaultCollection"). Must be a valid absolute URL pointing to the TFS collection.
   defaultValue: missing XML code comments
+- parameterName: Enabled
+  type: Boolean
+  description: Will be used if enabled
+  defaultValue: missing XML code comments
+- parameterName: EndpointEnrichers
+  type: List
+  description: missing XML code comments
+  defaultValue: missing XML code comments
 - parameterName: LanguageMaps
   type: TfsLanguageMapOptions
   description: Language mapping configuration for translating area and iteration path names between different language versions of TFS.
   defaultValue: missing XML code comments
+- parameterName: Name
+  type: String
+  description: missing XML code comments
+  defaultValue: missing XML code comments
 - parameterName: Project
   type: String
   description: Name of the TFS project within the collection to connect to. This is the project that will be used for migration operations.

docs/data/classes/reference.fieldmaps.fieldcalculationmap.yaml

@@ -79,6 +79,10 @@ options:
   type: List
   description: A list of Work Item Types that this Field Map will apply to. If the list is empty it will apply to all Work Item Types. You can use "*" to apply to all Work Item Types.
   defaultValue: missing XML code comments
+- parameterName: Enabled
+  type: Boolean
+  description: If set to `true` then the Fieldmap will run. Set to `false` and the processor will not run.
+  defaultValue: missing XML code comments
 - parameterName: expression
   type: String
   description: Gets or sets the NCalc expression to evaluate. Variables in the expression should be enclosed in square brackets (e.g., "[x]*2").

docs/data/classes/reference.fieldmaps.fieldclearmap.yaml

@@ -67,6 +67,10 @@ options:
   type: List
   description: A list of Work Item Types that this Field Map will apply to. If the list is empty it will apply to all Work Item Types. You can use "*" to apply to all Work Item Types.
   defaultValue: missing XML code comments
+- parameterName: Enabled
+  type: Boolean
+  description: If set to `true` then the Fieldmap will run. Set to `false` and the processor will not run.
+  defaultValue: missing XML code comments
 - parameterName: targetField
   type: String
   description: Gets or sets the name of the target field to be cleared/set to null during work item migration.

docs/data/classes/reference.fieldmaps.fieldliteralmap.yaml

@@ -69,6 +69,10 @@ options:
   type: List
   description: A list of Work Item Types that this Field Map will apply to. If the list is empty it will apply to all Work Item Types. You can use "*" to apply to all Work Item Types.
   defaultValue: missing XML code comments
+- parameterName: Enabled
+  type: Boolean
+  description: If set to `true` then the Fieldmap will run. Set to `false` and the processor will not run.
+  defaultValue: missing XML code comments
 - parameterName: targetField
   type: String
   description: Gets or sets the name of the target field that will be set to the specified literal value.

docs/data/classes/reference.fieldmaps.fieldmergemap.yaml

@@ -77,6 +77,10 @@ options:
   type: List
   description: A list of Work Item Types that this Field Map will apply to. If the list is empty it will apply to all Work Item Types. You can use "*" to apply to all Work Item Types.
   defaultValue: missing XML code comments
+- parameterName: Enabled
+  type: Boolean
+  description: If set to `true` then the Fieldmap will run. Set to `false` and the processor will not run.
+  defaultValue: missing XML code comments
 - parameterName: formatExpression
   type: String
   description: missing XML code comments