Submitting Bugs and Feature Requests

Before Submitting an Issue

First, please do a search of open issues to see if the issue or feature request has already been filed. Use the tags to narrow down your search. Here's an example of a query for Xamarin iOS specific issues.

If you find your issue already exists, make relevant comments and add your reaction. Use a reaction in place of a "+1" comment.

👍 - upvote

If your issue is a question, and is not addressed in the wiki documentation, please ask the question on Stack Overflow using the tag msal.

If you cannot find an existing issue that describes your bug or feature request, submit an issue using the guidelines below.

Write Detailed Bug Reports and Feature Requests

File a single issue per bug and feature request

• Do not enumerate multiple bugs or feature requests in the same issue.
• Do not add your issue as a comment to an existing issue unless it's for the identical input. Many issues look similar, but have different causes.

When submitting an issue, select the correct category, Bug Report, Documentation, or Feature request.

Bug Report

The more information you provide, the more likely someone will be successful in reproducing the issue and finding a fix. Please use the Bug Report template and complete as much of the information listed as possible. Please use the latest version of the library and see if your bug still exists before filing an issue. Remember to do the following:

• Search the issue repository to see if there exists a duplicate issue.
• Update to the latest version of the library to see if the issue still exists.
• Submit an issue by filling out all as much of the information in the Bug Report as possible.

Documentation Requests

If you find our wiki or xml comments are lacking in necessary documentation to make your life easier using the library, submit a Documentation request and let us know what you need, if you have found errors in the documentation, or if an example or code snippet is needed. Feel free to include suggestions.

Feature Requests

Have a feature request for MSAL? Complete a Feature Request or consider making a contribution to the library. Make sure your feature request is clear and concise and contains a detailed description of the problem. Please include any alternative solutions or features you may have considered.

Contributing Fixes

If you are interested in fixing issues and contributing directly to the code base, please see the Contributing overview.