为 Dynamics 365 文档做贡献

您可以通过两种方式为 Microsoft 的 Dynamics 365 文档做出贡献。 如果文章包含不正确或令人困惑的信息,或者您知道解决重复出现的问题的好方法,您可以使用文章中的反馈链接告诉我们。

对于我们的大部分文档,您还可以直接编辑文章以启动审查流程。

提供反馈

learn.microsoft.com 网站上,每篇学习文章均为您提供了提供反馈的机会。 您可以选择文章标题下方右上角位置的反馈操作,或选择文章底部反馈部分的反馈选项之一。 对文章进行评分,选择反馈的原因,并考虑发表评论。 反馈将发送给文章的作者和负责这些文档的团队。

如果文章无法直接编辑,或者您不方便编辑,我们建议您使用反馈机制告诉我们您对该文章或产品的看法。

对 Microsoft 文档的外部贡献

我们核心内容的源文件存储在公共 GitHub 存储库中。 任何人都可以查看它们,并且在许多情况下还可以编辑它们。 我们欢迎您以直接贡献或以 GitHub 问题的形式提出建议和更正,以报告错误或提出问题。 我们只能接受使用英语为源内容提出的反馈和贡献的见解。

大多数文章都带有铅笔图标和编辑此文档工具提示。选择图标以打开 GitHub 中的文章,然后开始编辑。 借助 Microsoft Learn 参与者指南开始您的贡献之旅

如果您要查阅和贡献新概念文章,请使用 https://github.com/MicrosoftDocs/dynamics365-docs-templates 中的模板。

Dynamics 365 指导内容

Dynamics 365 指南内容使用与 Microsoft Learn 上大多数文档相同的流程。 在此部分中,我们将介绍可用于帮助添加实施指南的工具和流程。

指导内容一词指 Dynamics 365 实施指南、业务流程的描述、新模式、最佳做法和引用体系结构。 我们于 2023 年 4 月发布了第一份指导内容,并且每两周增加一次更新内容。 浏览指导中心,然后告诉我们哪些方面比较好,哪些方面还有所欠缺。

部分指导内容由内部参与者贡献。 我们鼓励整个社区的行业专家帮助我们建立最佳做法。 如果您有最佳做法或其他您认为应该引入 Microsoft Learn 的见解,请继续阅读。

为什么要参与分享?

我们相信指导内容将有助于加快 Dynamics 365 实施项目的运行速度。 我们的合作伙伴和客户可以使用指导内容来为实施做好准备,并提高新领域的技能或培养新员工的技能。 软件开发人员可以将指导内容作为平台,用来推广他们的知识产权或行业专业知识。

但并非只有 Microsoft 才精通如何实施 Dynamics 365 解决方案。 社区中有许多专业人士,他们是实施的各个方面的专家。 您是否有在多个实施中运行良好的模式、最佳做法、配置或集成架构? 不妨考虑将它分享到 Microsoft Learn,让整个社区在实施项目时更有成效和更加高效。

我们希望最终能够向参与者给予奖励或其他认可。 2023 年,我们将在文章中表彰参与者

如何参与

从 2023 年 11 月开始,您可以在公共 GitHub 存储库中找到 Microsoft Dynamics 365 指导内容的源文件。 您还可以按照 Microsoft Learn 参与者指南中的说明,编辑 learn.microsoft.com/dynamics365/guidance 网站上的文章。

我们建议您通过与向 Microsoft Learn 的其他领域提交更正一样的方法提交更正内容。 但是,如果要提交内容,您需要将新指导内容的 Markdown 文件上传到不同的存储库,即 Dynamics 365 模式和实践存储库。 这样,我们就可以确保您的引用体系结构模式可以得到其他主题专家的审核。 有不同的模板可供选择,如果您想为业务流程内容做出贡献,则有完全不同的流程

模板

Microsoft 在两个位置提供模板,具体取决于模板的类型:

随着时间的推移,我们将添加更多的模板和指导。 我们建议您关注存储库,或通过收藏来保存存储库,以便在发生变化时收到通知。

在 Dynamics 365 模式和实践存储库中的 https://github.com/microsoft/dynamics365patternspractices/discussions 选项卡上共享您的反馈。

如果您还没有 GitHub 帐户,请从 Microsoft Learn 参与者指南开始。

提示

https://github.com/MicrosoftDocs/dynamics365-guidance 存储库中浏览我们的源文件。 学习我们构建不同类型文章的方式,以便使您的文章遵循相同的结构。 这样,审核流程就会变得更快。

体系结构

欢迎对体系结构指导贡献内容,包括解决方案想法和设计模式。 如果您有最佳做法或引用实施,请将您的建议提交给 Azure 团队,或在 Dynamics 365 中提交给我们。

要为 Dynamics 365 体系结构指导贡献新文章,请遵循以下主要步骤:

Microsoft 会处理该文章,并将它作为 Dynamics 365 指导文档的一部分发布。

有关 Microsoft 的指导内容的概要介绍,请访问 Azure 体系结构中心。 有关参与者指南,请参阅 Azure 体系结构中心贡献

GitHub 存储库 dynamics365-docs-templatesguidance-templates 文件夹中包含以下适用于体系结构指导的 Markdown 模板:

  • 普遍性体系结构模式:普遍性体系结构模式充当核心体系结构,带有适用于多种应用场景的通用解决方案。 例如,解决方案想法可以构建体系结构文章来展示特定行业或合作伙伴解决方案,并从每个解决方案想法链接到体系结构。 模板基于 Azure 体系结构指南模板。 将它用于不同类型的体系结构,包括引用体系结构。

  • 解决方案想法:解决方案想法是 Dynamics 365 实施的“小型”体系结构。 它们简要介绍了含 Dynamics 365 和 Azure 服务的解决方案。 每个解决方案想法都包含以下元素:

    • 体系结构图
    • 数据流
    • 组件,即所用服务的列表
    • 贡献者赞扬
    • 指向后续步骤和相关资源的链接,例如相关指南和体系结构
  • 示例解决方案:示例解决方案是采用“中型”体系结构的示例工作负载。 它们可指导读者完成解决方案设计流程,从而解决 Dynamics 365 实施中的特定问题。 示例解决方案提供基于实际客户示例的有指导意义的体系结构指导。 目标是通过向客户讲述曾经与他有着相同经历的其他客户的案例,来缩短他们的学习曲线。 它们包括解决方案想法模板中的各部分并添加了以下部分:

    • 备选方案,您可以改为插入到体系结构中的其他服务
    • 注意事项,映射到我们的 Success by Design 框架的指南,并且(可选)包括部署
  • 设计模式:Dynamics 365 设计模式可应对实施中的特定挑战,并且基于特定应用场景或最佳做法。 使用此模板来捕获业务流程模式。 或者,使用 dynamics365patternspractices/templates/business-processes 中的 Word 模板。

业务流程贡献

术语业务流程涵盖为实现预定的组织目标而进行的各种结构化(并且通常有一定顺序)的活动或任务。 该术语还可以指在实现业务目标过程中执行的所有步骤的累积效应。 业务流程对于各个解决方案(包括 Dynamics 365)而言是特定的。 我们相信,这个新的内容类型将创建一个结构,帮助客户和合作伙伴为采用 Dynamics 365 做好更完善的准备。 每个业务流程都包括一个标准业务流程流。 文档的各节内容将概括介绍配置步骤,以及用于每个配置步骤的数据实体。 每个步骤都链接到产品文档中的相关页面,所有文档都包含指向后续步骤及相关资源的链接,以帮助读者完成学习之旅。

我们在目录中构建了业务流程。 业务流程目录是一个 Excel 工作簿,Microsoft 使用它来组织业务流程文档中的工作并确定其优先顺序。 格式为 Excel,因为这种格式可以轻松排序和筛选条目。 我们还相信,我们的合作伙伴可以使用 Excel 工作簿来组织他们的加入流程、实施项目以及自己的业务流程。

请从 https://aka.ms/BusinessProcessCatalog 下载最新版本的目录。

注意

如果您想为业务流程做出贡献,请在开始之前注册您的作品,以降低其他人也在处理同一业务流程的风险。 要想注册您的作品,请在 https://github.com/microsoft/dynamics365patternspractices/issues 提交 GitHub 问题。

目录包含的内容

目录定义了四个级别的内容:

  1. 端到端流程

    我们已经确定了 15 种端到端场景。 我们用业务术语而不是软件技术术语来描述场景。

    对于每个端到端流程,介绍性文章描述了我们如何看待端到端流程。 我们列出了主要利益干系人,以及 Dynamics 365 如何为端到端流程提供帮助。 除了业务流程图,我们还概述了端到端流程之间如何相互交互。 介绍性文章中还列出了实施支持端到端流程的解决方案的先决条件。

  2. 业务流程领域

    每个端到端场景都涵盖两个或多个业务流程领域。 此级别只是对业务流程进行分组以便于搜索和导航的一种方式。 大多数情况下,业务流程领域按组织内的主要工作职能或部门划分。 目前,目录中定义了 90 多个业务流程领域。

  3. 业务流程

    术语业务流程涵盖为实现预定的组织目标而进行的各种结构化(并且通常有一定顺序)的活动或任务。 该术语还可以指在实现业务目标过程中执行的所有步骤的累积效应。 每个业务流程都描述了 Dynamics 365 支持的一项功能或一个流程。 到目前为止,我们已经确定了近 700 个业务流程。 一些业务流程适用于单个 Dynamics 365 应用,并且应用的文档可能已经描述了对应的流程。 通过在指南中收集所有业务流程,我们希望提供一个单一的入口点,其中包含指向相关产品特定内容的链接。

  4. 模式

    在 Dynamics 365 中,模式是指支持特定业务流程的可重复配置。 其中包括最常见的使用案例、应用场景和行业。 通常,有多种方式可以实施 Dynamics 365 来满足您的业务需求。 我们确定这些模式的目标是为您的实施提供一个基准。 我们已经确定了 2000 多种模式,并且预计这个数字会随着时间的推移而快速增长。

有关业务流程目录的进一步介绍,请访问关于业务流程指南

提交您的贡献内容

在 Microsoft 内部,我们正在努力将内部笔记、多年经验和各种文档转换为业务流程指导。 我们非常欢迎社区贡献内容。

根据文章类型,提交贡献内容有不同的模板。 参与者必须为他们想要做出贡献的文章类型选择正确的模板。 模板以 Word 文件的形式提供,从其名称中可以看出该模板适用的文章类型。

参与者认可

不论是内部还是外部参与者,只要他们通过 GitHub 提交贡献内容,Microsoft Learn 平台会在每篇文章的顶部显示他们。 有些人以其他方式贡献内容,因此我们在文章末尾添加参与者部分。

参与者部分会列出主要参与者及其姓名,以及指向其 LinkedIn 或其他个人资料(如果参与者曾经提供)的链接。 以下屏幕截图是 Azure 体系结构中心文章参与者部分的匿名版本。

“参与者”部分示例的屏幕截图,显示了主要作者,并列出了三位参与者以及指向其 LinkedIn 个人资料的链接。

这是它在 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  

是否以这种方式被列为参与者为可选操作。 在 Microsoft 中,如果外部参与者通过 GitHub 以外的其他方式提交引用体系结构和设计模式等新内容,我们建议使用参与者部分。