Contribuir com a documentação do Dynamics 365

Você pode contribuir com a documentação da Microsoft para o Dynamics 365 de duas maneiras. Se um artigo contiver informações incorretas ou confusas ou se você souber uma boa solução alternativa para um problema recorrente, poderá usar o link de comentários no artigo para nos informar.

Para a maior parte da nossa documentação, você também pode editar um artigo diretamente para iniciar um processo de revisão.

Fornecer comentários

No site do learn.microsoft.com , cada artigo do Learn oferece a oportunidade de você fornecer comentários. Você pode escolher a ação Comentários que está sob o título do artigo no canto superior direito ou uma das opções de comentários na parte inferior do artigo na seção Comentários . Dê uma classificação ao artigo, selecione o motivo de seus comentários e considere deixar um comentário. Os comentários vão para o autor do artigo e para a equipe proprietária dos documentos.

Se um artigo não puder ser editado diretamente ou se você não estiver familiarizado com a edição, recomendamos que você use o mecanismo de comentários para nos dizer o que você pensa sobre o artigo ou o produto.

Contribuições externas para a documentação da Microsoft

Os arquivos de origem para nosso conteúdo principal são armazenados em repositórios públicos do GitHub. Qualquer pessoa pode revisá-los e, em muitos casos, editá-los. Damos as boas-vindas às suas sugestões e correções, na forma de contribuições diretas ou como problemas do GitHub para relatar um bug ou fazer uma pergunta. Só podemos aceitar comentários e contribuições para o conteúdo de origem em inglês.

A maioria dos artigos tem um ícone de lápis com a dica de ferramenta Editar Este Documento. Selecione o ícone para abrir o artigo no GitHub e, em seguida, comece a editar. Comece como colaborador com o guia do colaborador do Microsoft Learn.

Se você quiser aprofundar-se e contribuir com novos artigos, use os modelos em https://github.com/MicrosoftDocs/dynamics365-docs-templates.

Conteúdo de diretrizes do Dynamics 365

O conteúdo de diretrizes do Dynamics 365 usa os mesmos processos que a maioria da documentação no Microsoft Learn. Nesta seção, destacamos ferramentas e processos que você pode usar para contribuir para adicionar às diretrizes de implementação.

O termo conteúdo de diretrizes cobre o guia de implementação do Dynamics 365, descrições de processos de negócios, novos padrões, práticas recomendadas e arquiteturas de referência. Publicamos o primeiro conteúdo de diretrizes em abril de 2023 e adicionamos atualizações a cada duas semanas. Navegue pelo hub de diretrizes e informe-nos o que é ótimo e o que está faltando.

Alguns dos conteúdos de diretrizes são fornecidos por colaboradores internos. Encorajamos especialistas em assuntos em toda a comunidade a nos ajudar a estabelecer práticas recomendadas. Leia se você tem uma prática recomendada ou outra percepção que você acha que deve fazer parte do Microsoft Learn.

Por que contribuir?

Acreditamos que o conteúdo de diretrizes ajuda a tornar os projetos de implementação do Dynamics 365 executados mais rapidamente. Nossos parceiros e clientes podem usar as diretrizes para se preparar para a implementação e se capacitar em novas áreas ou capacitar novos funcionários. Os desenvolvedores de software podem usar o conteúdo como uma plataforma para promover sua propriedade intelectual ou experiência no setor.

Mas nós da Microsoft não somos os únicos especialistas em como implementar soluções com o Dynamics 365. A comunidade inclui pessoas que são especialistas em vários aspectos da implementação. Você tem um padrão, uma prática recomendada, uma configuração ou uma arquitetura de integração que funciona bem em várias implementações? Considere compartilhá-lo aqui no Microsoft Learn para tornar toda a comunidade ainda mais produtiva e eficiente em seus projetos de implementação.

Esperamos poder oferecer recompensas ou outras confirmações para contribuições. Por enquanto, reconhecemos os colaboradores nos artigos de duas maneiras diferentes. Saiba mais na seção Reconhecimento do Colaborador .

Como contribuir

Você pode encontrar os arquivos de origem para o conteúdo de diretrizes do Dynamics 365 da Microsoft em um repositório público do GitHub. Você também pode editar os artigos no site learn.microsoft.com/dynamics365/guidance conforme descrito no guia de colaborador do Microsoft Learn.

Recomendamos que você envie correções da mesma forma que envia uma correção para outras áreas do Microsoft Learn. No entanto, para enviar novos conteúdos, pedimos que você carregue seus arquivos markdown para obter um novo conteúdo de diretriz para um repositório diferente, Padrões e Práticas do Dynamics 365. Dessa forma, podemos garantir que sua arquitetura ou padrão de referência seja revisado por outros especialistas no assunto. Há modelos diferentes para escolher e, se você quiser contribuir com o conteúdo do processo de negócios, há um processo completamente diferente.

Modelos

A Microsoft fornece modelos em dois locais, dependendo do tipo de modelo:

• Os modelos markdown estão no https://github.com/MicrosoftDocs/dynamics365-docs-templates repositório.

  • A pasta docs-templates contém modelos para artigos conceituais e de navegação.

  • A pasta /guidance-templates/ contém modelos para arquiteturas, ideias de solução e padrões. Esses modelos são os mesmos que são usados em toda a Microsoft, mas foram específicos para o Dynamics 365.

• Os modelos do Word e do PowerPoint estão no repositório padrões e práticas do Dynamics 365 .

  • A pasta /templates/business-processes/ contém modelos do Word para os artigos de processos de negócios. Convidamos todos os especialistas do assunto para nos ajudar a escrevê-los. A pasta também contém um arquivo do Excel com a lista de processos de negócios que identificamos. A lista evoluirá ao longo do tempo.

  • A pasta /graphics/ contém arquivos do PowerPoint para cada cenário de ponta a ponta, ao qual você pode adicionar seus próprios diagramas.

Adicionaremos mais modelos e diretrizes ao longo do tempo. Recomendamos que você siga os repositórios ou salve-os com uma estrela, para que você seja notificado quando algo mudar.

Compartilhe seus comentários na https://github.com/microsoft/dynamics365patternspractices/discussions aba no repositório de Padrões e Práticas do Dynamics 365.

Se você ainda não tiver uma conta do GitHub, comece a usar o guia de colaborador do Microsoft Learn.

Arquiteturas

Saudamos as contribuições de diretrizes arquitetônicas, incluindo ideias de solução e padrões de design. Se você tiver uma melhor prática ou implementação de referência, envie sua proposta para a equipe do Azure ou para nós no Dynamics 365.

Para contribuir com novos artigos para as diretrizes de arquitetura do Dynamics 365, siga estas etapas principais:

• Busque os modelos markdown apropriados da pasta guidance-templates no repositório GitHub dynamics365-docs-templates .
• Escreva sua contribuição.
• Envie seu artigo como um arquivo Markdown em uma solicitação de pull no repositório dynamics365patternspractices . A /submit-architecture/ pasta está pronta para receber suas contribuições.

A Microsoft processa o artigo e o publica como parte da documentação de diretrizes do Dynamics 365 .

Para obter uma introdução geral ao conteúdo de diretrizes na Microsoft, consulte o Centro de Arquitetura do Azure. Para o guia do colaborador, consulte as contribuições do Centro de Arquitetura do Azure.

O repositório GitHub dynamics365-docs-templates contém os seguintes modelos markdown para diretrizes arquitetônicas na pasta guidance-templates :

• Padrão de arquitetura generalizada: um padrão de arquitetura generalizado atua como uma arquitetura principal com uma solução comum que se aplica a muitos cenários. Por exemplo, ideias de solução podem se desenvolver a partir de um artigo de arquitetura para oferecer uma perspectiva para uma solução específica de um setor ou parceiro e vincular à arquitetura a partir de cada ideia de solução. O modelo é baseado no modelo do Guia de Arquitetura do Azure. Use-o para diferentes tipos de arquiteturas, incluindo arquiteturas de referência.

• Ideia da solução: as ideias de solução são arquiteturas "pequenas" das implementações do Dynamics 365. Eles fornecem breves visões gerais de soluções com os serviços do Dynamics 365 e do Azure. Cada ideia de solução contém os seguintes elementos:

  • Um diagrama de arquitetura
  • Um fluxo de dados
  • Componentes, ou seja, uma lista dos serviços usados
  • Créditos de colaborador
  • Links para as próximas etapas e recursos relacionados, como guias e arquiteturas relacionados

• Solução de exemplo: soluções de exemplo são cargas de trabalho de exemplo com arquiteturas "médias". Eles orientam os leitores durante o processo de criação de soluções para problemas específicos em implementações do Dynamics 365. Soluções de exemplo fornecem diretrizes de arquitetura acionáveis com base em exemplos reais do cliente. O objetivo é reduzir a curva de aprendizado dos clientes contando a história de outro cliente que teve o mesmo percurso. Elas incluem as seções do modelo de Ideia de Solução e adicionam as seguintes seções:

  • Alternativas, outros serviços que você pode conectar à arquitetura em vez disso
  • Considerações, diretrizes que mapeiam nossa estrutura Sucesso por Design e, opcionalmente, incluindo uma implantação.

• Padrão de design: os padrões de design do Dynamics 365 abordam desafios específicos nas implementações e se baseiam em um cenário específico ou prática recomendada. Use este modelo para capturar um padrão de processo de negócios. Como alternativa, use o modelo do Word em dynamics365patternspractices/templates/business-processes.

Contribuições do processo empresarial

O termo processo de negócios abrange uma ampla gama de atividades ou tarefas estruturadas, muitas vezes sequenciadas, para alcançar um objetivo organizacional predeterminado. O termo também pode se referir aos efeitos cumulativos de todas as etapas que estão progredindo em direção a uma meta de negócios. Os processos de negócios são particulares para soluções que incluem o Dynamics 365. Acreditamos que esse novo tipo de conteúdo cria uma estrutura que ajuda clientes e parceiros a estarem mais preparados para adotar o Dynamics 365. Cada processo de negócios inclui um diagrama de um fluxo de processo de negócios padrão. Seções do documento que descrevem as etapas de configuração e as entidades de dados usadas em cada uma das etapas. Cada etapa é vinculada à página relevante na documentação do produto e todos os documentos têm links para as próximas etapas e recursos relacionados para ajudar os leitores ao longo de sua jornada de aprendizagem.

Estruturamos os processos de negócios em um catálogo. O catálogo de processos de negócios é uma pasta de trabalho do Excel que usamos na Microsoft para organizar e priorizar nosso trabalho na documentação do processo empresarial. O formato é Excel porque facilita a classificação e o filtro das entradas. Também acreditamos que nossos parceiros podem usar a pasta de trabalho do Excel para organizar seus percursos de integração, seus projetos de implementação e seus próprios processos de negócios.

Baixe a versão mais recente do catálogo de https://aka.ms/BusinessProcessCatalog.

O que o catálogo contém

O catálogo define seis níveis de conteúdo:

1. Processos de ponta a ponta

   Um processo de ponta a ponta representa o fluxo completo de atividades do gatilho inicial para o resultado final. Ele abrange todas as etapas intermediárias e subprocessos necessários para atingir o objetivo de negócios. Identificamos 15 cenários de fim a fim. Descrevemos os cenários em termos de negócios, não em termos de tecnologia de software.

   Para cada processo de ponta a ponta, o artigo introdutório descreve como pensamos sobre o processo de ponta a ponta. Listamos os principais stakeholders e como o Dynamics 365 ajuda o processo de ponta a ponta. Também fornecemos uma visão geral, juntamente com um diagrama de fluxo de processo empresarial, de como o processo de ponta a ponta interage com outros processos de ponta a ponta. A introdução lista os pré-requisitos para implementar uma solução para dar suporte ao processo de ponta a ponta.

2. Áreas de processo de negócios

   Cada cenário de ponta a ponta abrange duas ou mais áreas de processo de negócios. Esse nível representa um agrupamento significativo de atividades relacionadas que contribuem para o objetivo geral e fornece uma maneira lógica de agrupar processos de negócios. Na maioria dos casos, as áreas de processo empresarial são separadas por funções de trabalho ou departamentos importantes em uma organização. Atualmente, o catálogo define mais de 100 áreas de processo de negócios.

3. Processos empresariais

   O termo processo de negócios abrange uma ampla gama de atividades ou tarefas estruturadas, muitas vezes sequenciadas, para alcançar uma meta organizacional predeterminada. O termo também pode se referir aos efeitos cumulativos de todas as etapas que estão progredindo em direção a uma meta de negócios. Cada processo de negócios descreve uma função ou processo compatível com o Dynamics 365. Até agora, identificamos mais de 800 processos de negócios. Alguns se aplicam a um único aplicativo do Dynamics 365 e a documentação do aplicativo já pode descrever o processo. Ao coletar todos os processos de negócios aqui no guia, esperamos fornecer um único ponto de entrada com links para conteúdo específico do produto relevante.

4. Cenários

   No Dynamics 365, os cenários são padrões de configurações repetíveis que dão suporte a um processo comercial específico. Eles incluem os casos de uso, cenários e setores mais comuns. Muitas vezes, há muitas maneiras de implementar o Dynamics 365 para atender aos seus requisitos de negócios. Nossa meta com padrões é fornecer uma linha de base para sua implementação. Identificamos mais de 3.000 cenários e padrões e esperamos que esse número cresça ao longo do tempo.

5. Processos do sistema

   Um processo do sistema é uma parte de um processo de negócios que usa um formulário, página ou interface do usuário específica no Dynamics 365.

6. Casos de teste

Um caso de teste é um conjunto detalhado de condições e etapas usadas para determinar se um aplicativo de software ou sistema funciona corretamente. É uma parte essencial do processo de teste de software, projetado para garantir que o software atenda aos seus requisitos e seja executado conforme o esperado. Os casos de teste são usados para identificar defeitos, garantir a qualidade e verificar se o software se comporta conforme pretendido em várias condições.

Há modelos do Word para cada tipo de conteúdo. As instruções são formatadas em vermelho entre colchetes, como no exemplo a seguir:[Text in red]. Exclua essas instruções ao finalizar o documento. O texto realçado em amarelo deve ser substituído ou ajustado por você. Não altere o texto que não está realçado em amarelo e não formatado em vermelho. Essas frases padrão ajudam os usuários a reconhecer o modelo para que possam examinar e encontrar o conteúdo que estão procurando com mais facilidade.

Obtenha uma introdução adicional ao catálogo de processos de negócios no guia Sobre o processo de negócios. Opcionalmente, examine os TechTalks em que falamos sobre como você pode usar o catálogo de processos empresariais e contribuir para a biblioteca de conteúdo.

Enviar sua contribuição

Internamente na Microsoft, estamos trabalhando duro para converter anotações internas, anos de experiência e vários documentos em diretrizes de processo de negócios. Saudamos muito as contribuições da comunidade.

Há modelos diferentes para enviar contribuições com base no tipo de artigo. Os colaboradores devem escolher o modelo certo para o tipo apropriado de artigo para o qual desejam contribuir. Os modelos estão disponíveis como arquivos do Word nomeados para explicar para que tipo de artigo o modelo se destina.

Reconhecimento do colaborador

A plataforma Microsoft Learn mostra colaboradores internos e externos na parte superior de cada artigo se eles enviaram sua contribuição por meio do GitHub. Algumas pessoas contribuem de outras maneiras, portanto, adicionamos uma seção Colaboradores no final do artigo.

A seção Colaboradores opcionais lista os principais colaboradores com seu nome e um link para o LinkedIn ou outro perfil se eles fornecerem um. A captura de tela a seguir é uma versão anônima da seção Colaboradores em um artigo do Centro de Arquitetura do Azure.

Veja como fica em Markdown.

## Contributors

*This article is maintained by Microsoft. It was originally written by the following contributors.*

Principal author:

* [Author's Name](https://www.linkedin.com/in/author-account/) | Author's job title or similar  

Other contributors:

* [Contributor's Name](https://www.linkedin.com/in/contributor-account/) | Contributor's job title or similar  
* [Contributor's Name](https://www.linkedin.com/in/contributor-account/) | Contributor's job title or similar  

Ser listado como colaborador dessa maneira é opcional. Em toda a Microsoft, recomendamos usar a seção Colaboradores se colaboradores externos enviarem novos conteúdos, como arquiteturas de referência e padrões de design, por meio de outros meios que não o GitHub.

Informações relacionadas

• Microsoft Learn guia do contribuidor
• Estender e colaborar na Ajuda para aplicativos de finanças e operações
• Estender e colaborar na Ajuda para o Dynamics 365 Business Central
• Contribuições do Centro de Arquitetura do Azure