From a03566da21530159175f9856a1fcce3438a09b29 Mon Sep 17 00:00:00 2001
From: Pieter Marsman <pietermarsman@gmail.com>
Date: Mon, 8 Jul 2019 23:03:47 +0200
Subject: [PATCH 1/3] Add contribution guidelines

---
 CONTRIBUTING.md | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 CONTRIBUTING.md

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..15c82ae
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,30 @@
+# Contributing guidelines
+
+Any contribution is appreciated! You might want to:
+
+* Fix spelling errors
+* Improve documentation
+* Add tests for untested code
+* Add new features
+* Fix bugs
+
+## How can I contribute?
+
+* Use [issues](https://github.com/pdfminer/pdfminer.six/issues) to report bugs and features
+* Fix issues by [creating pull requests](https://help.github.com/en/articles/creating-a-pull-request)
+* Help others giving your thoughts on open issues and pull requests.
+
+## General guidelines for creating issues and pull requests
+
+* Search previous issues, as yours might be a duplicate.
+* When creating a new issue for a bug, include a minimal reproducible example.
+* When creating a new issue for a feature, be sure to describe the context of the problem you are trying to solve. This
+  will help others to see the importance of your feature request. 
+* Link pull request to a single issue.
+* Pull requests should be merged to develop, not master. This ensures that master always equals the released verion.  
+* Include unit tests when possible. In case of bugs, this will help to prevent the same mistake in the future. In case 
+  of features, this will show that your code works correctly.
+* Code should work for Python 2.7 and Python 3.x (for now).
+* Code changes should conform to PEP8 coding style (with a line-width of 120). Existing code may stay as it is. 
+* New features should be well documented using docstrings.
+* Check spelling and grammar.
\ No newline at end of file

From 2743f2b20a304bc56cd306effdd32676b373ca70 Mon Sep 17 00:00:00 2001
From: Pieter Marsman <pietermarsman@gmail.com>
Date: Mon, 8 Jul 2019 23:05:47 +0200
Subject: [PATCH 2/3] Add reference to contribution guidelines in README.md

---
 README.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/README.md b/README.md
index 2a96278..4a863c5 100644
--- a/README.md
+++ b/README.md
@@ -81,6 +81,12 @@ TODO
  * Performance improvements.
 
 
+Contributing
+------------
+
+Be sure to read the [contribution guidelines](https://github.com/pdfminer/pdfminer.six/blob/master/CONTRIBUTING.md). 
+
+
 Terms and Conditions
 --------------------
 

From 5acfdd8f9ba73ad8770dc0bfdb76f2f4c9dcb307 Mon Sep 17 00:00:00 2001
From: Pieter Marsman <pietermarsman@gmail.com>
Date: Wed, 10 Jul 2019 19:38:38 +0200
Subject: [PATCH 3/3] Add sentence about including pdf's in issues

---
 CONTRIBUTING.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 15c82ae..b2680c2 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -11,6 +11,8 @@ Any contribution is appreciated! You might want to:
 ## How can I contribute?
 
 * Use [issues](https://github.com/pdfminer/pdfminer.six/issues) to report bugs and features
+    - If you report a bug in the results for a particular pdf, include that pdf. This allows others to replicate the
+     issue. 
 * Fix issues by [creating pull requests](https://help.github.com/en/articles/creating-a-pull-request)
 * Help others giving your thoughts on open issues and pull requests.