Ler en inglés

Compartir por


Contribución a los artículos de referencia de CSP

Los artículos de referencia de CSP se generan automáticamente mediante los archivos del marco de descripción del dispositivo (DDF) v2 que definen el CSP. Cuando corresponda, la definición de CSP incluye una asignación a una directiva de grupo. La automatización usa esta asignación, siempre que sea posible, para proporcionar una descripción sencilla de las directivas de CSP.

Importante

Cada artículo de CSP automatizado proporciona secciones modificables para proporcionar información adicional sobre el CSP, las directivas dentro del CSP y ejemplos de uso. Cualquier edición fuera de las secciones editables designadas se sobrescribe mediante la automatización.

Estructura de artículos de CSP

Cada artículo de CSP automatizado se divide en tres secciones.

Nota

Para ver estas secciones, visite el artículo que desea actualizar y, a continuación, seleccione el icono Lápiz . Captura de pantalla que muestra el icono de lápiz para editar un artículo publicado

  1. Encabezado: el encabezado incluye el nombre de CSP y proporciona una sección editable donde se puede proporcionar información adicional sobre el CSP.

    Captura de pantalla de la sección de encabezado csp

  2. Directivas: la sección directivas contiene una lista de directivas, donde cada directiva tiene una sección modificable para proporcionar información adicional y ejemplos.

    Captura de pantalla de la sección directiva de CSP

  3. Pie de página: el pie de página indica el final del artículo de CSP y proporciona una sección editable donde se puede proporcionar más información sobre el CSP.

    Captura de pantalla de la sección de pie de página de CSP

Proporcionar comentarios sobre la documentación

Los artículos de CSP se automatizan mediante los archivos DDF v2 y ADMX, que forman parte del código base de Windows. Intune catálogo de configuración también usa los archivos DDF v2 para presentar la configuración y el texto de ayuda. Por lo tanto, los comentarios de estos artículos se abordan mejor cuando se envían directamente al equipo de ingeniería mediante la aplicación Centro de comentarios. Los artículos de referencia de CSP y el catálogo de configuración de Intune se actualizan periódicamente con la copia más reciente de los archivos DDF v2 y se benefician de los comentarios abordados por el equipo de ingeniería.

Los artículos de CSP automatizados también contienen contenido modificable, que se conserva mediante la automatización. Para obtener comentarios sobre el contenido modificable, use la guía de colaboradores de documentación de Microsoft Learn.

Diagrama que muestra el flujo de comentarios de los artículos de CSP

Use estas secciones para determinar dónde debe enviar comentarios.

Comentarios sobre la descripción de la directiva

Las descripciones de directivas proceden de archivos DDF o ADMX y se encuentran dentro de la <[CSP-Name]-Description-Begin> sección de la directiva en el archivo markdown. <[CSP-Name]-Description-Begin> también incluye una referencia al origen que se usó para proporcionar la descripción de la directiva.

Cualquier información adicional sobre la configuración de directiva se puede proporcionar en la [Policy-Name]-Editable-Begin sección que sigue inmediatamente a la <[CSP-Name]-Description-End> sección. Esta sección permite una mayor expansión de la descripción de la directiva y se genera manualmente. Para obtener comentarios sobre el contenido editable, use la guía colaboradora de documentación de Microsoft Learn para actualizar la sección o enviar un problema.

Comentarios para ejemplos de directivas

La automatización no proporciona ejemplos de directiva. Cada nodo de directiva del archivo markdown incluye una [Policy-Name]-Examples-Begin sección que contiene los ejemplos. Si el ejemplo es incorrecto o necesita actualizarse, use la guía de colaboradores de documentación de Microsoft Learn para actualizar el ejemplo o enviar un problema.

Comentarios para la aplicabilidad de directivas

La aplicabilidad de directivas se define en el archivo DDF v2 del CSP. Cada nodo de directiva del archivo markdown incluye una [Policy-Name]-Applicability-Begin sección que contiene la aplicabilidad del sistema operativo.

Si es incorrecto o necesita actualizarse, envíe comentarios con la aplicación Centro de comentarios.

Comentarios sobre los valores permitidos de la directiva

Los valores permitidos de directiva se definen en el archivo DDF v2 para el CSP. Cuando corresponda, cada nodo de directiva del archivo markdown incluye una [Policy-Name]-AllowedValues-Begin sección que contiene una tabla que describe los valores permitidos para la directiva.

Si estos valores son incorrectos o necesitan actualizarse, envíe comentarios con la aplicación Centro de comentarios.

Comentarios para la asignación de directivas de grupo

Las asignaciones de directivas de grupo se definen en el archivo DDF v2 para el CSP. Cuando corresponda, cada nodo de directiva del archivo markdown incluye una [Policy-Name]-AdmxBacked-Begin sección o [Policy-Name]-GpMapping-Begin que contiene la asignación de directivas de grupo.

Si esta asignación es incorrecta, envíe comentarios con la aplicación Centro de comentarios.

Otros comentarios

Para cualquier otro comentario, use la guía de colaborador de documentación de Microsoft Learn.

Envío de comentarios con la aplicación Centro de comentarios

La aplicación Centro de comentarios le permite informar a Microsoft sobre cualquier problema que se encuentre al usar Windows. Para obtener más información sobre el uso del Centro de comentarios, consulte Envío de comentarios a Microsoft con la aplicación Centro de comentarios. Cuando envíe comentarios para la documentación de CSP con la aplicación Centro de comentarios, siga estos pasos:

  1. Escriba sus comentarios: anteponga el resumen [CSP Documentation] de sus comentarios en la sección Resumir sus comentarios . Agregue detalles sobre los comentarios, incluido el vínculo al artículo de CSP.
  2. Elija una categoría: seleccione Cuenta profesional o educativa de seguridad y privacidad > como categoría.
  3. Buscar comentarios similares: seleccione un comentario existente que coincida con sus comentarios, si procede.
  4. Agregar más detalles: seleccione Otro como subcategoría.
  5. Selecciona Enviar.