Contribute to the Help

Raksts
04/13/2023

This article describes how to contribute to our content in our MicrosoftDocs/Dynamics-365-Unified-Operations-public GitHub repo.

For information about how to create Markdown files in GitHub repos, see the Docs contributor guide. For information about how to deploy custom Help, see Custom Help overview.

Contribute to the content

One benefit of GitHub is that you can contribute to the core content that the Microsoft team provides in the MicrosoftDocs/Dynamics-365-Unified-Operations-public repo. For example, you have a new article that you think will be helpful to other users, or you have a correction to an existing article. If you want to contribute to the Dynamics-365-Unified-Operations-public repo, you can create a pull request from your repo to the Dynamics-365-Unified-Operations-public repo. The Microsoft team will then review the request and include your changes as appropriate.

You can also contribute and make edits to the existing documentation. To get started, select the Edit button (pencil symbol) in a article. The following video shows how you can contribute to the Microsoft documentation.

Note

Microsoft currently accepts pull requests only to the Dynamics-365-Unified-Operations-public repo.

Get started with GitHub

To join Microsoft in the world of GitHub and Markdown, you must be familiar with some new terminology and tools. The following list outlines the main steps, but you can find additional content, tools, and ideas in the GitHub documentation and other forums.

Sign up for GitHub.

For more information, see GitHub account setup and Install content authoring tools in the Docs contributor guide.
Fork the appropriate repo.

If you want to supplement Microsoft's content, then you do not need a fork of our repo. If you will customize Microsoft content using the MarkDown format, we recommend that you manually fork the relevant repo and use your favorite MarkDown editor. For more information, see Set up Git repository locally for documentation and Git and GitHub essentials for Docs in the Docs contributor guide.

Tip

You aren't required to make your GitHub repos public. When you fork a public repo, in the settings for the new repo, you can specify whether the repo is public, private, or available only to specific GitHub accounts.

Markdown format

The syntax that is used to format text for topics is named Markdig Flavored Markdown. This syntax complies with CommonMark. To learn more about how to work with Markdown, see Getting started with writing and formatting on GitHub.

You can convert content from Microsoft Word to Markdown by using open-source tools or other tools. In this way, you can easily recycle content.

Translate the content

If your solution is available in more than one country or region, you'll probably want to make the content available in multiple languages. There are lots of options for doing that. The following are a few examples:

Create the content in multiple languages.
Create the content in one language, and then translate it. For example, by using the Dynamics 365 Translation Service (DTS).
Pull Microsoft's English (United States) language content from our MicrosoftDocs/Dynamics-365-Unified-Operations-public repo, customize the Markdown files, translate them, and then use a third-party tool to build the HTML files.

Note

DTS isn't an option for translating the Microsoft content because it doesn't support Markdown files.

Dynamics 365 Translation Service

You can use the Dynamics 365 Translation Service (DTS) to translate your content into other languages. The service is hosted in Microsoft Dynamics Lifecycle Services (LCS), and currently supports translation of content in Word documents and HTML files. For more information, see Translate documentation files.

Kopīgot, izmantojot