Partilhar via


Como utilizar a documentação

Este artigo fornece recursos e dicas para a utilização da biblioteca de documentação Microsoft Endpoint Manager. Aplica-se ao Gestor de Configuração, Microsoft Intune e Autopilot, e abrange as seguintes áreas:

  • Como pesquisar
  • Submeter bugs, melhorias, perguntas e novas ideias
  • Como ser notificado das alterações
  • Como contribuir para os docs

Para obter ajuda e apoio geral, consulte:

Dica

Visite também o nó de documentação no espaço de trabalho comunitário da consola Do Gestor de Configuração. Este nó inclui informações atualizadas sobre documentação do Gestor de Configuração e artigos de apoio. Para obter mais informações, consulte utilizar a consola 'Gestor de Configuração'.

As informações deste artigo também se aplicam à documentação powerShell do Gestor de Configuração no refsitório sccm-docs-powershell.

Utilize as seguintes sugestões de procura para localizar as informações de que necessita:

  • Ao utilizar o seu motor de pesquisa preferido para localizar o conteúdo, inclua uma palavra-chave juntamente com as suas palavras-chave de pesquisa. Por exemplo, ConfigMgr para O Gestor de Configuração e para o Intune Intune.

    • Procure resultados docs.microsoft.com/mem de. Resultados de docs.microsoft.com/previous-versions , ou são para technet.microsoft.com msdn.microsoft.com versões de produtos mais antigos.

    • Para focar ainda mais os resultados de pesquisa na biblioteca de conteúdos atuais, inclua site:docs.microsoft.com na sua consulta para o âmbito do motor de busca.

  • Utilize termos de pesquisa que correspondam à terminologia na interface do utilizador e documentação online. Evite termos não oficiais ou abreviaturas que possa ver em conteúdos comunitários. Por exemplo, procure por:

    • "ponto de gestão" em vez de "MP"
    • "Tipo de implantação" em vez de "DT"
    • "Extensão de gestão intune" em vez de "IME"
  • Para pesquisar dentro do artigo atual, use a funcionalidade Localizar do seu navegador. Com a maioria dos navegadores web modernos, prima Ctrl + F e, em seguida, insira os seus termos de pesquisa.

  • Cada artigo inclui docs.microsoft.com os seguintes campos para ajudar a pesquisar o conteúdo:

    • Procure no canto superior direito. Para pesquisar por todos os artigos, insira os termos neste campo. Os artigos nesta biblioteca de conteúdos incluem automaticamente um dos seguintes âmbitos de pesquisa: ConfigMgr ou Intune .

      Campo de pesquisa de docs no cabeçalho

    • Filtrar por título acima da tabela esquerda de conteúdos. Para pesquisar a tabela de conteúdos atuais, insira os termos neste campo. Este campo apenas corresponde aos termos que aparecem nos títulos do artigo para o nó atual. Por exemplo, Infraestruturas core do gestor de configuração docs.microsoft.com/mem/configmgr/core () ou aplicações intune https://docs.microsoft.com/mem/intune/apps/ (). O último item nos resultados da pesquisa dá-lhe a opção de pesquisar os termos em toda a biblioteca de conteúdos.

      Animação de usar a tabela do filtro de conteúdos

Estás a ter problemas em encontrar alguma coisa? Feedback de arquivo! Quando arquivar um problema sobre os resultados da pesquisa, forneça o motor de busca que está a usar, as palavras-chave que tentou e o artigo-alvo. Este feedback ajuda a Microsoft a otimizar o conteúdo para uma melhor pesquisa.

Adicione um motor de pesquisa personalizado

Com muitos navegadores web modernos, você pode criar um motor de pesquisa personalizado. Utilize esta funcionalidade para pesquisar de forma rápida e docs.microsoft.com fácil. Por exemplo, com Microsoft Edge, versão 77 e posterior, utilize o seguinte processo:

  1. Em Microsoft Edge, versão 77 e posterior, abra Definições.

  2. No menu esquerdo, selecione Privacidade, pesquisa e serviços.

  3. Percorra a parte inferior do grupo Serviços e selecione a barra de endereços e procure.

  4. Selecione Gerir os motores de busca.

  5. Selecione Adicionar e especificar as seguintes informações:

    • Motor de busca: Introduza um nome amigável para identificá-lo na lista de motores de busca. Por exemplo, Microsoft docs.

    • Palavra-chave: Especifique um curto prazo para utilizar na barra de endereços para ativar este motor de busca. Por exemplo, memdocs.

    • URL com %s em vez de consulta: Por exemplo,

      https://docs.microsoft.com/en-us/search/index?search=%s&scope=ConfigMgr
      

      Nota

      Este exemplo é específico do ConfigMgr âmbito de aplicação. Pode remover a variável de âmbito para pesquisar tudo docs.microsoft.com ou utilizar um âmbito diferente.

      O motor de busca Microsoft Docs requer uma localidade no endereço. Por exemplo, en-us. Pode alterar a sua entrada para utilizar um local diferente.

    Adicione a Microsoft Edge um motor de pesquisa personalizado para o Microsoft Docs

Depois de adicionar este motor de busca, digite a sua palavra-chave na barra de endereços do navegador, Tab prima, escreva, em seguida, digite os termos de pesquisa e prima Enter . Procurará automaticamente o Microsoft Docs para os termos especificados utilizando o âmbito definido.

Sobre o feedback

Selecione o link De feedback no canto superior direito de qualquer artigo para ir à secção de Feedback na parte inferior. O feedback é integrado GitHub Questões. Para obter mais informações sobre esta integração com GitHub Questões, consulte o post de blog da plataforma docs.

Screenshot da secção de feedback em um artigo de docs

Para partilhar feedback não-docs sobre o próprio produto, selecione Este produto. Esta ação abre o site UserVoice do produto.

Para partilhar o feedback dos docs sobre o artigo atual, selecione Esta página. Uma conta GitHub é um pré-requisito para fornecer feedback de documentação. Uma vez que você entra, há uma autorização única para a organização MicrosoftDocs. Em seguida, abre o GitHub novo formulário de emissão. Adicione um título descritivo e feedback detalhado no corpo, mas não modifique a secção de detalhes do documento. Em seguida, selecione Enviar nova edição para apresentar uma nova emissão para o artigo-alvo no repositório MEMDocs GitHub.

Para ver se já existe feedback para este artigo, selecione Ver todos os comentários de página. Esta ação abre uma GitHub consulta sobre este artigo. Por predefinição, apresenta problemas abertos e fechados. Reveja qualquer feedback existente antes de submeter um novo problema. Se encontrar um problema relacionado, selecione o ícone facial para adicionar uma reação, adicione um comentário ao fio ou Subscreva para receber notificações.

Tipos de feedback

Utilize GitHub Questões para submeter os seguintes tipos de feedback:

  • Bug doc: O conteúdo está desatualizado, pouco claro, confuso ou quebrado.
  • Melhoramento do doc: Uma sugestão para melhorar o artigo.
  • Pergunta do doc: Precisa de ajuda para encontrar a documentação existente.
  • Ideia do doc: uma sugestão para um novo artigo. Utilize este método em vez do UserVoice para obter feedback de documentação.
  • Parabéns: Feedback positivo sobre um artigo útil ou informativo!
  • Localização: Feedback sobre a tradução de conteúdos.
  • Otimização do motor de busca (SEO): Feedback sobre problemas à procura de conteúdo. Inclua o motor de busca, palavras-chave e artigo-alvo nos comentários.

Se criar um problema para algo que não esteja relacionado com os docs, a Microsoft fechará o problema e redirecioná-lo-á para um canal de feedback melhor. Por exemplo:

Para partilhar feedback sobre a plataforma docs.microsoft.com fundamental, consulte o feedback do Docs. A plataforma inclui todos os componentes do invólucro, tais como o cabeçalho, tabela de conteúdos e menu certo. Também como os artigos prestam no navegador, como o tipo de letra, caixas de alerta e âncoras de página.

Notificações

Para receber notificações quando o conteúdo for alterar na biblioteca de documentação, utilize os seguintes passos:

  1. Utilize a pesquisa de documentos para encontrar um artigo ou conjunto de artigos. Por exemplo:

    • Procure um único artigo por título: "Quais as novidades em Microsoft Intune - Azure"

      Dica

      Para refinar uma única pesquisa de artigo para um único artigo, utilize o título completo que exibe nos resultados de pesquisa docs.microsoft.com. Este título é o que aparece no separador do navegador.

    • Pesquisa rumo a qualquer artigo do Gestor de Configuração sobre o BitLocker

  2. Na parte inferior da lista de resultados, selecione a ligação RSS.

    Screenshot dos resultados da pesquisa e link RSS

  3. Utilize este feed em qualquer aplicação RSS para receber notificações quando houver uma alteração em qualquer um dos resultados da pesquisa.

Vários artigos populares nesta biblioteca de conteúdos têm uma dica no topo com uma ligação pronta ao feed RSS.

Dica

Também pode ver o repositório MEMDocs no GitHub. Este método pode gerar muitas notificações. Também não inclui alterações do repositório privado que a Microsoft utiliza.

Contribuir

A biblioteca de documentação Microsoft Endpoint Manager, como a maioria dos conteúdos em docs.microsoft.com, é de origem aberta em GitHub. Esta biblioteca aceita e encoraja contribuições comunitárias. Para mais informações sobre como começar, consulte o Guia do Contribuinte. O único pré-requisito é criar uma conta GitHub.

Passos básicos para contribuir

  1. A partir do artigo-alvo, selecione Editar no canto superior direito. Esta ação abre o ficheiro de origem em GitHub.

  2. Para editar o ficheiro de origem, selecione o ícone do lápis.

    Screenshot do cabeçalho de ficheiro de origem GitHub

  3. Faça alterações na fonte de marcação. Para obter mais informações, consulte Como usar o Markdown para escrever Docs.

  4. Na secção de alteração de ficheiros Do Propõe, insira o comentário de compromisso público descrevendo o que mudou. Em seguida, selecione Proposta de alteração de ficheiros.

  5. Desça e verifique as alterações que fez. Selecione Criar pedido de puxar para abrir o formulário. Descreva por que fez esta mudança. Selecione Criar pedido de puxar.

A equipa de escrita recebe o seu pedido de atração, e atribui-o ao escritor apropriado. O autor revê o texto, e faz uma edição rápida passar nele. Ou aprovam e fundem as alterações, ou contactam-no para obter mais informações sobre a atualização.

O que contribuir

Se quiser contribuir, mas não sabe por onde começar, consulte as seguintes sugestões:

  • Reveja um artigo para obter precisão. Em seguida, atualize os metadados ms.date utilizando mm/dd/yyyy o formato. Esta contribuição ajuda a manter o conteúdo fresco.

  • Adicione esclarecimentos, exemplos ou orientações com base na sua experiência. Esta contribuição usa o poder da comunidade para partilhar conhecimento.

  • Traduções corretas numa língua não inglesa. Esta contribuição melhora a usabilidade dos conteúdos localizados.

  • Pesse na lista de problemas para as etiquetas dirigidas à comunidade:

    • boa primeira edição

    • help wanted (ajuda necessária)

      Os autores da Microsoft podem atribuir estes rótulos a questões que são bons candidatos à contribuição da comunidade. São usados principalmente para os docs PowerShell do Gestor de Configuração.

Nota

As grandes contribuições requerem a assinatura de um Contrato de Licença de Contribuição (CLA) se não for um funcionário da Microsoft. GitHub automaticamente exige que assine este acordo quando uma contribuição cumpre o limiar. Só precisas de assinar este acordo uma vez.

Dicas de contribuição

Siga estas orientações gerais quando contribuir:

(Esta lista foi emprestada do guia contribuidor .NET.)