Thank you for contributing to this project! Before submitting your pull request, be sure to consider the following.
The code in this repository serves two purposes:
- The sample project in the user-auth folder is the source for a Microsoft Graph quick start.
- The code in the user-auth and app-auth folders are directly referenced by Microsoft Graph tutorials
This is important to keep in mind, because changes in one place may require changes in another, to keep things in sync. The Markdown files for the tutorials refer to the source code files directly (using a custom :::code syntax), so that updating code in source will automatically update the code in Markdown.
The :::code syntax used in Markdown depends on specific comments in the source code file. These comments look like the following:
// <MySnippet>
Console.WriteLine("Hello World!");
// </MySnippet>If you update code between these "marker" comments, the Markdown files will automatically get those changes when published to the Microsoft Graph documentation site. If you update code outside of those comments, it's very likely that you'll need to update the corresponding Markdown in the Microsoft Graph training repository.
While the enthusiasm is appreciated, please don't send pull requests to add new features to the sample. Because this repository is primarily a "build your first app" tutorial, the feature set is limited, by design.
Please submit all pull requests to the main branch.
Publishing of updates to the Microsoft Graph tutorials site is not automatic. Changes must first be promoted to the live branch, then a build must be triggered by the site admins. This is typically done on an "as-needed" basis.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.