Updated CONTRIBUTING.md

CHANGELOG

@@ -18,7 +18,7 @@ mkdocs-material-1.9.0 (2017-08-29)
 
 mkdocs-material-1.8.1 (2017-08-07)
 
-  * Fixed #429: Missing pagination for GitHub API
+  * Fixed #421: Missing pagination for GitHub API
 
 mkdocs-material-1.8.0 (2017-08-02)
 

CONTRIBUTING.md

@@ -10,7 +10,7 @@ you do, please read the following guidelines.
 For quick questions there's no need to open an issue as you can reach us on
 [gitter.im][1].
 
-  [1]: https://gitter.im/mkdocs-material/general
+  [1]: https://gitter.im/squidfunk/mkdocs-material
 
 ### Found a bug?
 
@@ -30,12 +30,12 @@ proposal for your work first, to be sure that it is of use for everyone, as
 the Material theme is highly opinionated. Please consider what kind of change
 it is:
 
-* For a **Major Feature**, first open an issue and outline your proposal so
+* For a **major feature**, first open an issue and outline your proposal so
   that it can be discussed. This will also allow us to better coordinate our
   efforts, prevent duplication of work, and help you to craft the change so
   that it is successfully accepted into the project.
 
-* **Small Features** and bugs can be crafted and directly submitted as a Pull
+* **Small features and bugs** can be crafted and directly submitted as a Pull
   Request. However, there is no guarantee that your feature will make it into
   the master, as it's always a matter of opinion whether if benefits the
   overall functionality of the theme.
@@ -66,8 +66,8 @@ go ahead.
   make your changes in a separate git branch and add descriptive messages to
   your commits.
 
-2. **Build**: Before submitting a pull requests, build the theme. This is a
+2. **Build**: Before submitting a pull requests, [build the theme][5]. This is
-  mandatory requirement for your PR to get accepted, as the theme should at
+  a mandatory requirement for your PR to get accepted, as the theme should at
   all times be installable through GitHub.
 
 3. **Pull Request**: After building the theme, commit the compiled output, push
@@ -78,4 +78,5 @@ go ahead.
 After your PR is merged, you can safely delete your branch and pull the changes
 from the main (upstream) repository.
 
-  [4]: http://squidfunk.github.io/mkdocs-material/customization/#theme-development
+  [4]: http://squidfunk.github.io/mkdocs-material/customization/#environment-setup
+  [5]: http://squidfunk.github.io/mkdocs-material/customization/#build-process

docs/contributing.md

@@ -1,81 +0,0 @@
-# Contributing
-
-Interested in contributing to the Material theme? Want to report a bug? Before
-you do, please read the following guidelines.
-
-## Submission context
-
-### Got a question or problem?
-
-For quick questions there's no need to open an issue as you can reach us on
-[gitter.im][1].
-
-  [1]: https://gitter.im/squidfunk/mkdocs-material
-
-### Found a bug?
-
-If you found a bug in the source code, you can help us by submitting an issue
-to the [issue tracker][2] in our GitHub repository. Even better, you can submit
-a Pull Request with a fix. However, before doing so, please read the
-[submission guidelines][3].
-
-  [2]: https://github.com/squidfunk/mkdocs-material/issues
-  [3]: #submission-guidelines
-
-### Missing a feature?
-
-You can request a new feature by submitting an issue to our GitHub Repository.
-If you would like to implement a new feature, please submit an issue with a
-proposal for your work first, to be sure that it is of use for everyone, as
-the Material theme is highly opinionated. Please consider what kind of change
-it is:
-
-* For a **major feature**, first open an issue and outline your proposal so
-  that it can be discussed. This will also allow us to better coordinate our
-  efforts, prevent duplication of work, and help you to craft the change so
-  that it is successfully accepted into the project.
-
-* **Small features and bugs** can be crafted and directly submitted as a Pull
-  Request. However, there is no guarantee that your feature will make it into
-  the master, as it's always a matter of opinion whether if benefits the
-  overall functionality of the theme.
-
-## Submission guidelines
-
-### Submitting an issue
-
-Before you submit an issue, please search the issue tracker, maybe an issue for
-your problem already exists and the discussion might inform you of workarounds
-readily available.
-
-We want to fix all the issues as soon as possible, but before fixing a bug we
-need to reproduce and confirm it. In order to reproduce bugs we will
-systematically ask you to provide a minimal reproduction scenario using the
-custom issue template. Please stick to the issue template.
-
-Unfortunately we are not able to investigate / fix bugs without a minimal
-reproduction scenario, so if we don't hear back from you we may close the issue.
-
-### Submitting a Pull Request (PR)
-
-Search GitHub for an open or closed PR that relates to your submission. You
-don't want to duplicate effort. If you do not find a related issue or PR,
-go ahead.
-
-1. **Development**: Fork the project, set up the [development environment][4],
-  make your changes in a separate git branch and add descriptive messages to
-  your commits.
-
-2. **Build**: Before submitting a pull requests, build the theme. This is a
-  mandatory requirement for your PR to get accepted, as the theme should at
-  all times be installable through GitHub.
-
-3. **Pull Request**: After building the theme, commit the compiled output, push
-  your branch to GitHub and send a PR to `mkdocs-material:master`. If we
-  suggest changes, make the required updates, rebase your branch and push the
-  changes to your GitHub repository, which will automatically update your PR.
-
-After your PR is merged, you can safely delete your branch and pull the changes
-from the main (upstream) repository.
-
-  [4]: http://squidfunk.github.io/mkdocs-material/customization/#theme-development

docs/contributing.md

@@ -0,0 +1 @@
+../CONTRIBUTING.md

docs/release-notes.md

@@ -37,9 +37,9 @@ pip show mkdocs-material | grep -E ^Version
 
 ### 1.8.1 <small>_ August 7, 2017</small>
 
-* Fixed [#429][429]: Missing pagination for GitHub API
+* Fixed [#421][421]: Missing pagination for GitHub API
 
-  [429]: https://github.com/squidfunk/mkdocs-material/issues/429
+  [421]: https://github.com/squidfunk/mkdocs-material/issues/421
 
 ### 1.8.0 <small>_ August 2, 2017</small>