Drop Py35, update guides, Makefile, and CI config (#251)

Copied over some updated guides and CI configuration from Fatiando a
Terra. Includes a maintenance guide for review PRs and making releases.
Some Makefile rules have changed to make things simpler.

Also decided to drop Python 3.5 so we don't have to test against it or
be limited by things that are 3.6+ only. Should be OK since most people
are on 2.7 or 3.6 and Anaconda now ships with 3.7 by default.

Simplified the README as well because PyPI will fail to render the `raw`
rst directive.

Fixes some lint errors because of an update in pylint.

Adds names to the Travis CI builds to make the matrix easier to read.

Author: leouieda

.pylintrc

@@ -50,7 +50,7 @@ confidence=
 # --enable=similarities". If you want to run only the classes checker, but have
 # no Warning level messages displayed, use"--disable=all --enable=classes
 # --disable=W"
-disable=print-statement,parameter-unpacking,unpacking-in-except,old-raise-syntax,backtick,long-suffix,old-ne-operator,old-octal-literal,import-star-module-level,raw-checker-failed,bad-inline-option,locally-disabled,locally-enabled,file-ignored,suppressed-message,useless-suppression,deprecated-pragma,apply-builtin,basestring-builtin,buffer-builtin,cmp-builtin,coerce-builtin,execfile-builtin,file-builtin,long-builtin,raw_input-builtin,reduce-builtin,standarderror-builtin,unicode-builtin,xrange-builtin,coerce-method,delslice-method,getslice-method,setslice-method,no-absolute-import,old-division,dict-iter-method,dict-view-method,next-method-called,metaclass-assignment,indexing-exception,raising-string,reload-builtin,oct-method,hex-method,nonzero-method,cmp-method,input-builtin,round-builtin,intern-builtin,unichr-builtin,map-builtin-not-iterating,zip-builtin-not-iterating,range-builtin-not-iterating,filter-builtin-not-iterating,using-cmp-argument,eq-without-hash,div-method,idiv-method,rdiv-method,exception-message-attribute,invalid-str-codec,sys-max-int,bad-python3-import,deprecated-string-function,deprecated-str-translate-call,attribute-defined-outside-init,bad-continuation
+disable=print-statement,parameter-unpacking,unpacking-in-except,old-raise-syntax,backtick,long-suffix,old-ne-operator,old-octal-literal,import-star-module-level,raw-checker-failed,bad-inline-option,locally-disabled,locally-enabled,file-ignored,suppressed-message,useless-suppression,deprecated-pragma,apply-builtin,basestring-builtin,buffer-builtin,cmp-builtin,coerce-builtin,execfile-builtin,file-builtin,long-builtin,raw_input-builtin,reduce-builtin,standarderror-builtin,unicode-builtin,xrange-builtin,coerce-method,delslice-method,getslice-method,setslice-method,no-absolute-import,old-division,dict-iter-method,dict-view-method,next-method-called,metaclass-assignment,indexing-exception,raising-string,reload-builtin,oct-method,hex-method,nonzero-method,cmp-method,input-builtin,round-builtin,intern-builtin,unichr-builtin,map-builtin-not-iterating,zip-builtin-not-iterating,range-builtin-not-iterating,filter-builtin-not-iterating,using-cmp-argument,eq-without-hash,div-method,idiv-method,rdiv-method,exception-message-attribute,invalid-str-codec,sys-max-int,bad-python3-import,deprecated-string-function,deprecated-str-translate-call,attribute-defined-outside-init,bad-continuation,import-error
 
 # Enable the message, report, category or checker with the given id(s). You can
 # either give multiple identifier separated by comma (,) or put this option

.travis.yml

@@ -1,62 +1,77 @@
+# Configuration file for TravisCI
+
+# We use miniconda for Python so don't need any Python specific tools
 language: generic
 
+# Use the container builds so we don't need sudo priviledges
 sudo: false
 
+# Only build pushes to the master branch and tags. This avoids the double
+# builds than happen when working on a branch instead of a fork.
 branches:
     only:
         - master
         # Regex to build tagged commits with version numbers
         - /\d+\.\d+(\.\d+)?(\S*)?$/
 
+# Define environment variables common to all builds
 env:
     global:
-        # CODACY_PROJECT_TOKEN to upload coverage to codacy
-        - secure: "neO+GkXP+ohhnfAg+VUh7kPQtaXNASv6levimV8hzj7Cd+nv9xrzPeq56Goh/TAeoYscM/IUB/vK6xwYfJOJeS2c4jsPqzqXZl+LIaxxU+HvvTewLnYNpg/+uKJ6sGVArC67DVTl9M6sJG2+AxoqB/0xJ46YAhH6a2bwXbMl1h/UILxy15oqTtFsgga0NPikVLLra00U5kChVjbkahPOgLuntLTMr62AJ92MZPy3jgCjVQO944KhCs1yy0LiErLTgFu2N8pTl62ZBVK40B6KkLepcJmRBCC6+qrG4ZRCHXIZyp/qs/YYxXVBSTEW/coQmZ9pNVVsPxTC+9x0otMAHeePp5/Nk9zt4m2R6AF+sN2da0NHwBK98JXSIQWi50hFeYaTSYaeaL6vSB3ievLkE+pku22hYEU5h9fBql4pnok4QUbyGSAQdxKDOuUEus1+3+H1PwksLpiwcImHfH0T5z+jxwfNHnjdhtADc/zgpGR0v0FIMMCauknjNCzRoUBBPDbmQyQFzP+0KityySA0SXKP8L9bOUxRcf1BDi5G96i0RWKCYRGet7OaQ5ynt3Z8X4ery2S3nCx4CmSXX3C0NSfeZu3Pkof+fcOdvxh+orOvRCqRJ9hh7lZyyB4kecGjJJbF5JC3rXE5efcWBgDOzhJevU5hDH2lURKeJBpeN1Y="
+        # Encrypted variables
         # Github Token for pushing the built docs (GH_TOKEN)
         - secure: "QII0477v0mmCCW3qSNXLCOtqraJaCICtSghiyrxYsuUdJTrXzXBNhX2KLIjcKYXOK1HdwYOFGf8xBVLl44clHlAW7R32ecEGeTJizr0yqTBvT3rNG1Xb7+E6jdXqrIs//PmPRaF8zOZxPl1SJKDK4jJpCx5HnAflg7wl/6tQLD6K3/dQ6FG2s3UKsc8o4qchOiEfxYhOuKo3jt2S0HdsNAQFw3mFHCCrclxDr3llSQtWSY0mirZnta7AI4nMvzxl2nUhdHEpxgzIjWxCWLAwmj3/NxLz0VSgNCtl2bNYk6AYrc5RcANGk2fcYaZr9mTU3Aax60S4389B39Pq95hBN21jYdbw9vCN810dYpTUk2siLysx8gF6r2JWEF8SskXlF79r3phtaFTMOS4GqeiuwjifZeaLAL/H1PTQFDDG/UKEwBpLuzrPMDw/84iRtyWKqWR/f14YdKhH4YAkcOuRglEXiI/1A0qWKiZ1iZfky8Tys+wN5nyss23w/JeYXVgBdTkNzvp3diFWK8+Wl9j3HYpX9LlEHJwASA1wHLL85t4ToymgLjo9gvLvwzB7T+fWNtEbh4ELbvI7jaKrvir8uSGYy4bGbfRclh5CktD//mTLhDyAsQDS8obF/Ri9mVqFzjK6417ORfu8qnpXU+mIHPRBoKvpS2WqnPtSwF8KPv8="
         # TWINE_PASSWORD to deploy to PyPI
         - secure: "md4fgPt9RC/sCoN5//5PcNHLUd9gWQGewV5hFpWW88MRTjxTng1Zfs8r7SqlF2AkEEepFfyzq0BEe9c3FMAnFbec3KmqdlQen4V8xDbLrcTlvkPlTrYGbAScUvdhhqojB//hMHoTD4KvxAv9CiUwFBO4hCMmj2buWHUbV9Ksu5WCW9mF/gkt/hIuYAU6Mbwt8PiYyMgUpzMHO1vruofcWRaVnvKwmBqHB0ae86D4/drpwn4CWjlM12WUnphT2bssiyPkw24FZtCN6kPVta6bLZKBxu0bZpw2vbXuUG+Yh19Q4mp8wNYT3XSHJf8Hl5LfujF48+cLWu+6rlCkdcelyVylhWLFc3rGOONAv4G8jWW2yNSz/bLQfJnMpd81fQEu5eySmFxB7mdB0uyKpvIG1jMJQ73LlYKakKLAPdYhMFyQAHoX9gvCE3S4QR95DBMi5gM/pZubOCcMLdjPHB5JKpJHSjxbOzyVwgmsUIEgd5Bi2vZvvYQXn1plk4xpQ3PhXc+/gi33bzY89mKcfOn0HJ2pD1vLqDXRCBsMCakoLZ0JB/6bacaz4FngbsGWuQ+I1cz20lJGL/MSi9bW1G7Uoidt3GXXWDmXrWt70vIXlLIxr8XV0Mu/rPbauGgWE+ZSYEfvdM5sP+FNF7vQ5de+Fkvzg5Z3tTfR+O1W+d7+vM4="
         - TWINE_USERNAME=Leonardo.Uieda
-        - COVERAGE=false
+        # The file with the listed requirements to be installed by conda
+        - CONDA_REQUIREMENTS=requirements.txt
+        - CONDA_REQUIREMENTS_DEV=requirements-dev.txt
+        # Get GMT6 from the development channel
+        - CONDA_EXTRA_CHANNEL=conda-forge/label/dev
+        # These variables control which actions are performed in a build
+        - TEST=false
         - CHECK=false
         - BUILD_DOCS=false
         - DEPLOY_DOCS=false
         - DEPLOY_PYPI=false
-        - CONDA_REQUIREMENTS="requirements.txt"
-        # Get GMT6 from the development channel
-        - CONDA_EXTRA_CHANNEL=conda-forge/label/dev
 
 matrix:
     # Build under the following configurations
     include:
-        - os: linux
+        - name: "Style checks"
+          os: linux
           env:
-              - PYTHON=3.5
+              - PYTHON=3.6
+              - CHECK=true
+              # Don't need to install everything just to run the style checks
+              - CONDA_INSTALL_EXTRA="black flake8 pylint"
+              - CONDA_REQUIREMENTS=""
+              - CONDA_REQUIREMENTS_DEV=""
+        - name: "Linux - Python 3.7"
+          os: linux
+          env:
+              - PYTHON=3.7
+              - TEST=true
               - BUILD_DOCS=true
-        - os: linux
+        - name: "Linux - Python 3.6 (also deploys)"
+          os: linux
           env:
               - PYTHON=3.6
-              - COVERAGE=true
-              - CHECK=true
+              - TEST=true
               - BUILD_DOCS=true
               - DEPLOY_DOCS=true
               - DEPLOY_PYPI=true
-        - os: linux
+        - name: "Mac - Python 3.7"
+          os: osx
           env:
               - PYTHON=3.7
+              - TEST=true
               - BUILD_DOCS=true
-        - os: osx
-          env:
-              - PYTHON=3.5
-              - BUILD_DOCS=true
-        - os: osx
+        - name: "Mac - Python 3.6"
+          os: osx
           env:
               - PYTHON=3.6
-              - COVERAGE=true
-              - BUILD_DOCS=true
-        - os: osx
-          env:
-              - PYTHON=3.7
+              - TEST=true
               - BUILD_DOCS=true
 
 before_install:
@@ -65,9 +80,6 @@ before_install:
     # Download and install miniconda and setup dependencies
     # Need to source the script to set the PATH variable globaly
     - source continuous-integration/travis/setup-miniconda.sh
-    - if [ "$COVERAGE" == "true" ]; then
-        pip install codecov codacy-coverage codeclimate-test-reporter;
-      fi
     # Show installed pkg information for postmortem diagnostic
     - conda list
 
@@ -78,31 +90,27 @@ install:
 
 script:
     # Check code for style and lint for code quality
-    # Black is Python 3.6 only so it can't be in the requirements file.
     - if [ "$CHECK" == "true" ]; then
-        conda install --yes --quiet black python=$PYTHON;
         make check;
+        make lint;
       fi
     # Run the test suite. Make pytest report any captured output on stdout or stderr.
-    - if [ "$COVERAGE" == "true" ]; then
-        make coverage PYTEST_EXTRA="-r P";
-      else
-        make test PYTEST_EXTRA="-r P";
+    - if [ "$TEST" == "true" ]; then
+          pip install codecov;
+          make test PYTEST_EXTRA="-r P";
       fi
     # Build the documentation
     - if [ "$BUILD_DOCS" == "true" ]; then
         make -C doc all;
       fi
 
+# Things to do if the build is successful
 after_success:
-    - if [ "$COVERAGE" == "true" ]; then
+    # Upload coverage information
+    - if [ "$TEST" == "true" ]; then
+        coverage xml;
         echo "Uploading coverage to Codecov";
         codecov -e PYTHON;
-        coverage xml;
-        echo "Uploading coverage to Codacy";
-        python-codacy-coverage -r coverage.xml;
-        echo "Uploading coverage to Code Climate";
-        codeclimate-test-reporter;
       fi
 
 deploy:

AUTHORS.md

@@ -1,16 +1,11 @@
 # Project Contributors
 
-## History
-
 This project was started in 2017 by [Leonardo Uieda](http://www.leouieda.com)
-during
-[an NSF funded postdoc](http://www.leouieda.com/blog/hawaii-gmt-postdoc.html)
-with [Paul Wessel](http://www.soest.hawaii.edu/wessel)
-at the University of Hawaii.
-
-## People
+during [an NSF funded postdoc](http://www.leouieda.com/blog/hawaii-gmt-postdoc.html)
+with [Paul Wessel](http://www.soest.hawaii.edu/wessel) at the University of Hawaii at
+Manoa.
 
-The following people have contributed code to the project:
+The following people have contributed code to the project (alphabetical by last name):
 
-* [Leonardo Uieda](http://www.leouieda.com/)
 * [Dongdong Tian](https://seisman.info/)
+* [Leonardo Uieda](http://www.leouieda.com/)