mkdocs-material/CONTRIBUTING.md

# Contributing

Material for MkDocs is an actively maintained and constantly improved project 
that serves a diverse user base with varying backgrounds and needs. In order to 
effectively address the needs of all our users, evaluatgit e requests, and fix bugs, 
we maintainers need to put in a lot of work. We have devoted significant effort 
to creating better templates for our issue tracker, optimizing the processes for 
our users to report bugs, request features or changes, contribute to the 
project, or exchange with our community. 

Given the wealth of valuable knowledge contained in numerous issues and 
discussions, we consider our [issue tracker] and [discussion board] to serve as a 
crucial __knowledge base__ that is an important addition to our [documentation] 
and brings value to both new and experienced users of Material for MkDocs.

## How to contribute

Selecting the appropriate contribution template is essential to maintain the 
organization, searchability, and ease of use of this knowledge base. In this 
section of our documentation, we outline the available options and their 
respective procedures.

  [discussion board]: https://github.com/squidfunk/mkdocs-material/discussions
  [issue tracker]: https://github.com/squidfunk/mkdocs-material/issues
  [documentation]: https://squidfunk.github.io/mkdocs-material/
  

### Creating an issue

-   #### [Report a bug][report a bug]

    __Something is not working?__ Report a bug in Material for MkDocs by creating an issue with a reproduction

-   #### [Report a docs issue][report a docs issue]

    __Missing information in our docs?__ Report missing information or potential inconsistencies in our documentation 

-   #### [Request a change][request a change]

    __Want to submit an idea?__ Propose a change or feature request or suggest an improvement

-   #### [Ask a question][ask a question]

    __Have a question or need help?__ Ask a question on our discussion board and get in touch with our community

### Contributing to this project

-   #### [Add a translation](https://github.com/squidfunk/mkdocs-material/adding-a-translation)
    
    __Missing support for your language?__ Add missing translations for a new or supported language

-   #### [Create a pull request](https://github.com/squidfunk/mkdocs-material/creating-a-pull-request) 
    
    __Want to create a pull request?__ Learn how to create a comprehensive pull request (PR)

  [report a bug]: reporting-a-bug.md
  [report a docs issue]: reporting-a-docs-issue.md
  [request a change]: requesting-a-change.md
  [ask a question]: https://github.com/squidfunk/mkdocs-material/discussions