Partilhar via

Contribuindo para os artigos de referência do CSP

Os artigos de referência CSP são gerados automaticamente usando os arquivos DDF (estrutura de descrição do dispositivo) v2 que definem o CSP. Quando aplicável, a definição de CSP inclui um mapeamento para uma política de grupo. A automação usa esse mapeamento, quando possível, para fornecer uma descrição amigável para as políticas CSP.

Importante

Cada artigo CSP automatizado fornece seções editáveis para fornecer informações adicionais sobre o CSP, as políticas dentro do CSP e os exemplos de uso. Todas as edições fora das seções editáveis designadas são substituídas pela automação.

Estrutura de artigos do CSP

Cada artigo CSP automatizado é dividido em três seções.

Observação

Para exibir essas seções, visite o artigo que você deseja atualizar e selecione o ícone Lápis . Captura de tela mostrando o ícone Lápis para editar um artigo publicado

  1. Cabeçalho: o cabeçalho inclui o nome CSP e fornece uma seção editável em que podem ser fornecidas informações adicionais sobre o CSP.

    Captura de tela da seção cabeçalho CSP

  2. Políticas: a seção políticas contém uma lista de políticas, em que cada política tem uma seção editável para fornecer informações e exemplos adicionais.

    Captura de tela da seção política CSP

  3. Rodapé: o rodapé indica o final do artigo CSP e fornece uma seção editável em que mais informações sobre o CSP podem ser fornecidas.

    Captura de tela da seção rodapé CSP

Fornecer comentários sobre documentação

Os artigos CSP são automatizados usando os arquivos DDF v2 e ADMX, que fazem parte da base de código do Windows. Intune catálogo de configurações também usa os arquivos DDF v2 para apresentar as configurações e ajudar o texto. Como tal, os comentários desses artigos são melhor abordados quando enviados diretamente à equipe de engenharia usando o aplicativo Do Hub de Comentários. Os artigos de referência CSP e o catálogo de configurações de Intune são atualizados periodicamente usando a cópia mais recente dos arquivos DDF v2 e se beneficiam dos comentários abordados pela equipe de engenharia.

Artigos CSP automatizados também contêm conteúdo editável, que é preservado pela automação. Para obter comentários sobre o conteúdo editável, use o guia contribuidor de documentação do Microsoft Learn.

Diagrama mostrando o fluxo de comentários para artigos CSP

Use estas seções para determinar onde você deve enviar comentários.

Comentários para descrição da política

As descrições da política são originadas de arquivos DDF ou ADMX e estão localizadas na <[CSP-Name]-Description-Begin> seção para a política no arquivo de markdown. <[CSP-Name]-Description-Begin> também inclui uma referência à origem que foi usada para fornecer a descrição da política.

Qualquer informação adicional sobre a configuração da política pode ser fornecida na [Policy-Name]-Editable-Begin seção que segue imediatamente a <[CSP-Name]-Description-End> seção. Esta seção permite uma expansão adicional da descrição da política e é gerada manualmente. Para obter qualquer comentário sobre o conteúdo editável, use a documentação do Microsoft Learn contribuidor guia para atualizar a seção ou enviar um problema.

Comentários sobre exemplos de política

Os exemplos de política não são fornecidos pela automação. Cada nó de política no arquivo markdown inclui uma [Policy-Name]-Examples-Begin seção que contém os exemplos. Se o exemplo estiver incorreto ou precisar ser atualizado, use a documentação do Microsoft Learn contribuidor guia para atualizar o exemplo ou enviar um problema.

Comentários sobre aplicabilidade de política

A aplicabilidade da política é definida no arquivo DDF v2 para o CSP. Cada nó de política no arquivo de markdown inclui uma [Policy-Name]-Applicability-Begin seção que contém a aplicabilidade do sistema operacional.

Se estiver incorreto ou precisar ser atualizado, envie comentários com o aplicativo Hub de Comentários.

Comentários sobre valores permitidos pela política

Os valores permitidos pela política são definidos no arquivo DDF v2 para o CSP. Quando aplicável, cada nó de política no arquivo markdown inclui uma [Policy-Name]-AllowedValues-Begin seção que contém uma tabela que descreve os valores permitidos para a política.

Se esses valores estiverem incorretos ou precisarem ser atualizados, envie comentários com o aplicativo Hub de Comentários.

Comentários sobre mapeamento de política de grupo

Os mapeamentos de política de grupo são definidos no arquivo DDF v2 para o CSP. Quando aplicável, cada nó de política no arquivo de markdown inclui uma [Policy-Name]-AdmxBacked-Begin seção ou [Policy-Name]-GpMapping-Begin que contém o mapeamento da política de grupo.

Se esse mapeamento estiver incorreto, envie comentários com o aplicativo Hub de Comentários.

Outros comentários

Para qualquer outro comentário, use o guia contribuidor de documentação do Microsoft Learn.

Enviar comentários com o aplicativo Hub de Comentários

O aplicativo Do Hub de Comentários permite que você conte à Microsoft sobre os problemas que você encontrar ao usar o Windows. Para obter mais informações sobre como usar o Hub de Comentários, consulte Enviar comentários para a Microsoft com o aplicativo Hub de Comentários. Ao enviar comentários sobre a documentação do CSP com o aplicativo Hub de Comentários, use estas etapas:

  1. Insira seus comentários: prefixe seu resumo de comentários na [CSP Documentation] seção Resumir seus comentários . Adicione detalhes sobre os comentários, incluindo o link para o artigo CSP.
  2. Escolha uma categoria: Selecione Segurança e Privacidade > Trabalho ou Conta Escolar como a categoria.
  3. Encontre comentários semelhantes: selecione um comentário existente que corresponda aos seus comentários, se aplicável.
  4. Adicione mais detalhes: selecione Outros como a subcategoria.
  5. Selecione Enviar.