Add words

diff --git a/.github/CODE_OF_CONDUCT.md b/.github/CODE_OF_CONDUCT.md
new file mode 100644 (file)
index 0000000..977709f
--- /dev/null
+++ b/.github/CODE_OF_CONDUCT.md
@@ -0,0 +1,13 @@
+# Treat each other well
+
+Everyone participating in the Black project, and in particular in the
+issue tracker, pull requests, and social media activity, is expected
+to treat other people with respect and more generally to follow the
+guidelines articulated in the [Python Community Code of
+Conduct](https://www.python.org/psf/codeofconduct/).
+
+At the same time, humor is encouraged.  In fact, basic familiarity with
+Monty Python's Flying Circus is expected.  We are not savages.
+
+And if you *really* need to slap somebody, do it with a fish while
+dancing.

diff --git a/.github/ISSUE_TEMPLATE.md b/.github/ISSUE_TEMPLATE.md
new file mode 100644 (file)
index 0000000..9eb7565
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE.md
@@ -0,0 +1,14 @@
+Howdy! Sorry you're having trouble. To expedite your experience,
+provide some basics for me:
+
+Operating system:
+Python version:
+Black version:
+Does also happen on master:
+
+To answer the last question, follow these steps:
+* create a new virtualenv (make sure it's the same Python version);
+* clone this repository;
+* run `pip install -e .`;
+* make sure it's sane by running `python setup.py test`; and
+* run `black` like you did last time.

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644 (file)
index 0000000..596ce73
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,61 @@
+# Contributing to Black
+
+Welcome! Happy to see you willing to make the project better. Have you
+read the entire [README](README.md) yet?
+
+
+## Bird's eye view
+
+In terms of inspiration, *Black* is about as configurable as *gofmt* and
+*rustfmt* are.  This is deliberate.
+
+Bug reports and fixes are always welcome!  Please follow the issue
+template for best results.
+
+Before you suggest a new feature or configuration knob, ask yourself why
+you want it.  If it enables better integration with some workflow, fixes
+an inconsistency, speeds things up, and so on - go for it!  On the other
+hand, if your answer is "because I don't like a particular formatting"
+then you're not ready to embrace *Black* yet. Such changes are unlikely
+to get accepted. You can still try but prepare to be disappointed.
+
+
+## Technicalities
+
+Development on the latest version of Python is preferred.  As of this
+writing it's 3.6.4.  You can use any operating system.  I am using macOS
+myself and CentOS at work.
+
+Install all development dependencies using:
+```
+$ pipenv install --dev
+```
+If you haven't used `pipenv` before but are comfortable with virtualenvs,
+just run `pip install pipenv` in the virtualenv you're already using and
+invoke the command above from the cloned Black repo. It will do the
+correct thing.
+
+Before submitting pull requests, run tests with:
+```
+$ python setup.py test
+```
+
+Also run mypy and flake8 on `black.py` and `test_black.py`.  Travis will
+run all that for you but if you left any errors here, it will be quicker
+and less embarrassing to fix them locally ;-)
+
+
+## Hygiene
+
+If you're fixing a bug, add a test.  Run it first to confirm it fails,
+then fix the bug, run it again to confirm it's really fixed.
+
+If adding a new feature, add a test.  In fact, always add a test.  But
+wait, before adding any large feature, first open an issue for us to
+discuss the idea first.
+
+
+## Finally
+
+Thanks again for your interest in improving the project!  You're taking
+action when most people decide to sit and watch.

diff --git a/README.md b/README.md
index b1c74b5a8d7d2e373d828e78c80faf1c1b52a0ee..c1fd95ab5fccdf3722a3eec80382257fc826f337 100644 (file)
--- a/README.md
+++ b/README.md
@@ -253,6 +253,8 @@ answer is "because I don't like a particular formatting" then you're not
 ready to embrace *Black* yet. Such changes are unlikely to get accepted.
 You can still try but prepare to be disappointed.
 
+More details can be found in [CONTRIBUTING](CONTRIBUTING.md).
+
 
 ## Change Log