Add a new article for CSP contribution

windows/client-management/mdm/contribute-csp-reference.md

@@ -0,0 +1,86 @@
+---
+title: Contributing to CSP reference articles
+description: Learn more about contributing to the CSP reference articles.
+author: vinaypamnani-msft
+manager: aaroncz
+ms.author: vinpa
+ms.date: 05/11/2023
+ms.localizationpriority: medium
+ms.prod: windows-client
+ms.technology: itpro-manage
+ms.topic: ref
+---
+
+# Contributing to the CSP reference articles
+
+CSP reference articles are automatically generated using the [device description framework (DDF)](configuration-service-provider-ddf.md) v2 files that define the CSP. When applicable, the CSP definition includes a mapping to a group policy. These mappings are utilized by the automation, when possible, to provide a friendly description for the CSP policies.
+
+> [!IMPORTANT]
+> Each automated CSP article provides editable sections to provide additional information about the CSP or the policies within the CSP. Any edits outside the designated editable sections are overwritten by the automation.
+
+## CSP article structure
+
+Each automated CSP article is broken into three sections.
+
+> [!NOTE]
+> To view these sections, visit the article that you want to update, then select the **Pencil** icon
+>
+> :::image type="content" source="../../../images/pencil-icon.png" alt-text="Screenshot showing the Pencil icon to edit a published article":::
+
+1. **Header**: The header includes the CSP name, and provides an editable section where additional information about the CSP can be provided.
+
+   :::image type="content" source="images/csp-header.png" alt-text="Screenshot of the CSP header section":::
+
+1. **Policies**: The policies section contains a list of policies, where each policy has an editable section for providing additional information and examples.
+
+   :::image type="content" source="images/csp-policy.png" alt-text="Screenshot of the CSP policy section":::
+
+1. **Footer**: The footer indicates the end of the CSP article, and provides an editable section where more information about the CSP can be provided.
+
+   :::image type="content" source="images/csp-footer.png" alt-text="Screenshot of the CSP footer section":::
+
+## Provide feedback on documentation
+
+As most of the CSP articles are automated, the feedback for these articles is best addressed when submitted using [Feedback Hub app](https://support.microsoft.com/windows/send-feedback-to-microsoft-with-the-feedback-hub-app-f59187f8-8739-22d6-ba93-f66612949332). However for non-automated content, use the guidance for [Editing Windows IT professional documentation](../../../CONTRIBUTING.md).
+
+Use the sections below to determine where you should submit feedback.
+
+### Feedback for policy description
+
+Policy descriptions are sourced from DDF or ADMX files and are located within the `<[CSP-Name]-Description-Begin>` section for the policy in the markdown file. `<[CSP-Name]-Description-Begin>` also includes a reference to the source that was used to provide the policy description.
+
+- `Description-Source-ADMX` or `Description-Source-ADMX-Forced`: The description was captured from the group policy that the CSP setting maps to. If this description is incorrect, [Send feedback to Microsoft with the Feedback Hub app](https://support.microsoft.com/windows/send-feedback-to-microsoft-with-the-feedback-hub-app-f59187f8-8739-22d6-ba93-f66612949332).
+- `Description-Source-DDF` or `Description-Source-DDF-Forced`: The description was captured from the DDF file that defines the CSP. If this description is incorrect, [Send feedback to Microsoft with the Feedback Hub app](https://support.microsoft.com/windows/send-feedback-to-microsoft-with-the-feedback-hub-app-f59187f8-8739-22d6-ba93-f66612949332).
+- `Description-Source-Manual-Forced`: The description is defined in the automation code. If this description is incorrect, [submit a GitHub issue](../../../CONTRIBUTING.md#using-issues-to-provide-feedback-on-documentation).
+
+Any additional information about the policy setting can be provided in the `[Policy-Name]-Editable-Begin` section that immediately follows the `<[CSP-Name]-Description-End>` section. This section provides the ability to further expand the policy description, and is generated manually. For any feedback for the editable content, use the guidance for [Editing Windows IT professional documentation](../../../CONTRIBUTING.md) to update the section or submit an issue.
+
+### Feedback for policy examples
+
+Policy examples are not provided by the automation. Each policy node in the markdown file includes a `[Policy-Name]-Examples-Begin` section which contains the examples. If the example is incorrect or needs to be updated, use the guidance for [Editing Windows IT professional documentation](../../../CONTRIBUTING.md) to update the example or submit an issue.
+
+### Feedback for policy applicability
+
+Policy applicability is defined in the DDF v2 file for the CSP. Each policy node in the markdown file includes a `[Policy-Name]-Applicability-Begin` section which contains the operating system applicability.
+
+If it is incorrect or needs to be updated, [Send feedback to Microsoft with the Feedback Hub app](https://support.microsoft.com/windows/send-feedback-to-microsoft-with-the-feedback-hub-app-f59187f8-8739-22d6-ba93-f66612949332).
+
+### Feedback for policy allowed values
+
+Policy allowed values are defined in the DDF v2 file for the CSP. When applicable, each policy node in the markdown file includes a `[Policy-Name]-AllowedValues-Begin` section which contains the operating system applicability.
+
+If these values are incorrect or need to be updated, [Send feedback to Microsoft with the Feedback Hub app](https://support.microsoft.com/windows/send-feedback-to-microsoft-with-the-feedback-hub-app-f59187f8-8739-22d6-ba93-f66612949332).
+
+### Feedback for group policy mapping
+
+Group policy mappings are defined in the DDF v2 file for the CSP. When applicable, each policy node in the markdown file includes a `[Policy-Name]-AdmxBacked-Begin` or `[Policy-Name]-GpMapping-Begin` section which contains the group policy mapping.
+
+If this mapping is incorrect, [Send feedback to Microsoft with the Feedback Hub app](https://support.microsoft.com/windows/send-feedback-to-microsoft-with-the-feedback-hub-app-f59187f8-8739-22d6-ba93-f66612949332).
+
+### Other feedback
+
+For any other feedback, use the guidance for [Editing Windows IT professional documentation](../../../CONTRIBUTING.md).
+
+## Related articles
+
+- [Contributor guide overview](https://learn.microsoft.com/contribute/)

windows/client-management/mdm/policy-csp-admx-cpls.md

@@ -1,6 +1,6 @@
 ---
-title: ADMX_Cpls Policy CSP
+title: [CSP-Name] Policy CSP
-description: Learn more about the ADMX_Cpls Area in Policy CSP.
+description: Learn more about the [CSP-Name] Area in Policy CSP.
 author: vinaypamnani-msft
 manager: aaroncz
 ms.author: vinpa
@@ -13,83 +13,74 @@ ms.topic: reference
 
 <!-- Auto-Generated CSP Document -->
 
-<!-- ADMX_Cpls-Begin -->
+<!-- [CSP-Name]-Begin -->
-# Policy CSP - ADMX_Cpls
+# Policy CSP - [CSP-Name]
 
 [!INCLUDE [ADMX-backed CSP tip](includes/mdm-admx-csp-note.md)]
 
-<!-- ADMX_Cpls-Editable-Begin -->
+<!-- [CSP-Name]-Editable-Begin -->
 <!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
-<!-- ADMX_Cpls-Editable-End -->
+<!-- [CSP-Name]-Editable-End -->
 
-<!-- UseDefaultTile-Begin -->
+<!-- [Policy-Name]-Begin -->
-## UseDefaultTile
+## [Policy-Name]
 
-<!-- UseDefaultTile-Applicability-Begin -->
+<!-- [Policy-Name]-Applicability-Begin -->
 | Scope | Editions | Applicable OS |
 |:--|:--|:--|
-| ✅ Device <br> ❌ User | ✅ Pro <br> ✅ Enterprise <br> ✅ Education <br> ✅ Windows SE | ✅ Windows 10, version 2004 [10.0.19041.1202] and later <br> ✅ Windows 10, version 2009 [10.0.19042.1202] and later <br> ✅ Windows 10, version 21H1 [10.0.19043.1202] and later <br> ✅ Windows 11, version 21H2 [10.0.22000] and later |
+| ✅ Device <br> ❌ User | ✅ Pro <br> ✅ Enterprise <br> ✅ Education <br> ✅ Windows SE | ✅ Windows 10, version 21H1 [10.0.19043.1202] and later |
-<!-- UseDefaultTile-Applicability-End -->
+<!-- [Policy-Name]-Applicability-End -->
 
-<!-- UseDefaultTile-OmaUri-Begin -->
+<!-- [Policy-Name]-OmaUri-Begin -->
 ```Device
-./Device/Vendor/MSFT/Policy/Config/ADMX_Cpls/UseDefaultTile
+./Device/Vendor/MSFT/Policy/Config/[CSP-Name]/[Policy-Name]
 ```
-<!-- UseDefaultTile-OmaUri-End -->
+<!-- [Policy-Name]-OmaUri-End -->
 
-<!-- UseDefaultTile-Description-Begin -->
+<!-- [Policy-Name]-Description-Begin -->
 <!-- Description-Source-ADMX -->
-This policy setting allows an administrator to standardize the account pictures for all users on a system to the default account picture. One application for this policy setting is to standardize the account pictures to a company logo.
+This policy setting allows an administrator to...
+<!-- [Policy-Name]-Description-End -->
 
-> [!NOTE]
+<!-- [Policy-Name]-Editable-Begin -->
-> The default account picture is stored at %PROGRAMDATA%\Microsoft\User Account Pictures\user.jpg. The default guest picture is stored at %PROGRAMDATA%\Microsoft\User Account Pictures\guest.jpg. If the default pictures don't exist, an empty frame is displayed.
-
-- If you enable this policy setting, the default user account picture will display for all users on the system with no customization allowed.
-
-- If you disable or don't configure this policy setting, users will be able to customize their account pictures.
-<!-- UseDefaultTile-Description-End -->
-
-<!-- UseDefaultTile-Editable-Begin -->
 <!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
-<!-- UseDefaultTile-Editable-End -->
+<!-- [Policy-Name]-Editable-End -->
 
-<!-- UseDefaultTile-DFProperties-Begin -->
+<!-- [Policy-Name]-DFProperties-Begin -->
 **Description framework properties**:
 
 | Property name | Property value |
 |:--|:--|
 | Format | `chr` (string) |
 | Access Type | Add, Delete, Get, Replace |
-<!-- UseDefaultTile-DFProperties-End -->
+<!-- [Policy-Name]-DFProperties-End -->
 
-<!-- UseDefaultTile-AdmxBacked-Begin -->
+<!-- [Policy-Name]-AdmxBacked-Begin -->
 [!INCLUDE [ADMX-backed policy note](includes/mdm-admx-policy-note.md)]
 
 **ADMX mapping**:
 
 | Name | Value |
 |:--|:--|
-| Name | UseDefaultTile |
+| Name | [Policy-Name] |
-| Friendly Name | Apply the default account picture to all users |
+| Friendly Name | [Group policy friendly name] |
-| Location | Computer Configuration |
+| Location | [Computer/User Configuration] |
-| Path | Control Panel > User Accounts |
+| Path | [Group policy path] |
-| Registry Key Name | Software\Microsoft\Windows\CurrentVersion\Policies\Explorer |
+| ADMX File Name | [ADMX-File-Name] |
-| Registry Value Name | UseDefaultTile |
+<!-- [Policy-Name]-AdmxBacked-End -->
-| ADMX File Name | Cpls.admx |
-<!-- UseDefaultTile-AdmxBacked-End -->
 
-<!-- UseDefaultTile-Examples-Begin -->
+<!-- [Policy-Name]-Examples-Begin -->
 <!-- Add any examples for this policy here. Examples outside this section will get overwritten. -->
-<!-- UseDefaultTile-Examples-End -->
+<!-- [Policy-Name]-Examples-End -->
 
-<!-- UseDefaultTile-End -->
+<!-- [Policy-Name]-End -->
 
-<!-- ADMX_Cpls-CspMoreInfo-Begin -->
+<!-- [CSP-Name]-CspMoreInfo-Begin -->
 <!-- Add any additional information about this CSP here. Anything outside this section will get overwritten. -->
-<!-- ADMX_Cpls-CspMoreInfo-End -->
+<!-- [CSP-Name]-CspMoreInfo-End -->
 
-<!-- ADMX_Cpls-End -->
+<!-- [CSP-Name]-End -->
 
 ## Related articles
 
-[Policy configuration service provider](policy-configuration-service-provider.md)
+[Policy configuration service provider](policy-configuration-service-provider.md)

windows/client-management/mdm/toc.yml

@@ -3,6 +3,8 @@ items:
   href: index.yml
   expanded: true
   items:
+  - name: Contributing to CSP reference
+    href: contribute-csp-reference.md
   - name: Device description framework (DDF) files
     href: configuration-service-provider-ddf.md
   - name: Support scenarios