Welcome to the repository for the developer and ITpro content for Dynamics NAV 2018 including PaaS. The repo started as a private repo, but it is now made public, and we welcome contributions submitted through pull requests.
All articles are stored as Markdown files (.md type) in the dynamics-nav folder. They publish to Docs here: https://docs.microsoft.com/en-us/dynamics-nav/getting-started.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.
-
Fork this repo
You cannot work directly in the navdevitpro-content-pr repo, so the first thing you need to do is create a fork of the repo under your GitHub account. A fork basically is copy of this repo that lets you work freely on the content without affecting the navdevitpro-content-pr repo. For more information, see Fork a Repo
-
Install GitHub Desktop (optional) and clone your forked repo.
GitHub Desktop makes is easy to work and collaborate with repos locally from your own desktop. For more information, see GitHub Desktop.
-
Get hold of your favorite MarkDown editor, and start making changes.
The help content is stored in the dynamics-nav folder of the repo. Articles use a syntax for formatting text called GitHub Flavored Markdown. To learn more about working with markdown, see Getting started with writing and formatting on GitHub.
The repo contains other folders that are used for purposes other than publishing to the https://docs.microsoft.com/en-us/dynamics-nav/ site.
A benefit of GitHub is the ability for you to contribute to the core content that Microsoft provides in the navdevitpro-content-pr repo. For example, you might have a new article that you think would be beneficial or you might have a correction to an existing article. If you would like to contribute to the navdevitpro-content-pr repo, you create what is called a pull request from your repo to the navdevitpro-content-pr repo. The Dynamics NAV UA team will then review the request and include the changes as appropriate.
For example, to create a pull request to the navdevitpro-content-pr repo by using GitHub Desktop, do the following:
- Commit the changes to your repo that you want to include in the pull request.
- Choose Sync to push the changes up to your repo on GitHub.
- When the sync is completed, choose Pull Request, and then choose send Pull Request.
You can get additional tips and tricks for how to contribute in the Docs Contributor Guide and in the contributor guide for Microsoft Dynamics 365 Business Central at https://docs.microsoft.com/dynamics365/business-central/dev-itpro/help/contributor-guide.