Add a CONTRIBUTING.md file. (#425)

This branch adds a skeleton of contribution guidelines and cleans up
little bits that I noticed along the way.

For #424

Author: mblayman

LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2014 nGen Works Company and individual contributors.
+Copyright (c) 2018 nGen Works Company and individual contributors.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

docs/CONTRIBUTING.md

@@ -0,0 +1,30 @@
+Contributing
+============
+
+DJA should be easy to contribute to.
+If anything is unclear about how to contribute,
+please submit an issue on GitHub so that we can fix it!
+
+How
+---
+
+Before writing any code,
+have a conversation on a GitHub issue
+to see if the proposed change makes sense
+for the project.
+
+Fork DJA on [GitHub](https://github.com/django-json-api/django-rest-framework-json-api) and
+[submit a Pull Request](https://help.github.com/articles/creating-a-pull-request/)
+when you're ready.
+
+For maintainers
+---------------
+
+To upload a release (using version 1.2.3 as the example):
+
+```bash
+(venv)$ python setup.py sdist bdist_wheel
+(venv)$ twine upload dist/*
+(venv)$ git tag -a v1.2.3 -m 'Release 1.2.3'
+(venv)$ git push --tags
+```

docs/_static/.gitkeep

@@ -13,6 +13,7 @@
 # All configuration values have a default; values that are commented out
 # serve to show the default.
 
+import datetime
 import sys
 import os
 import shlex
@@ -52,8 +53,9 @@
 
 # General information about the project.
 project = 'Django REST Framework JSON API'
-copyright = '2015, Jerel Unruh and contributors'
-author = 'Jerel Unruh'
+year = datetime.date.today().year
+copyright = '{}, Django REST Framework JSON API contributors'.format(year)
+author = 'Django REST Framework JSON API contributors'
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
@@ -235,7 +237,7 @@
 #  author, documentclass [howto, manual, or own class]).
 latex_documents = [
   (master_doc, 'DjangoRESTFrameworkJSONAPI.tex', 'Django REST Framework JSON API Documentation',
-   'Jerel Unruh', 'manual'),
+   'Django REST Framework JSON API contributors', 'manual'),
 ]
 
 # The name of an image file (relative to this directory) to place at the top of

docs/conf.py

@@ -14,6 +14,7 @@ Contents:
    getting-started
    usage
    api
+   CONTRIBUTING
 
 Indices and tables
 ==================

docs/index.rst

@@ -1,15 +1,16 @@
 -e .
+django-debug-toolbar
 django-polymorphic>=2.0
+factory-boy
 Faker
 isort
 mock
+packaging==16.8
 pytest
 pytest-django
-factory-boy
 pytest-factoryboy
 recommonmark
 Sphinx
 sphinx_rtd_theme
 tox
-django-debug-toolbar
-packaging==16.8
+twine