aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorFlorian Rathgeber <florian.rathgeber@gmail.com>2017-12-06 22:11:55 +0000
committerFlorian Rathgeber <florian.rathgeber@gmail.com>2017-12-06 22:16:03 +0000
commit575884cfef6e719e1cb86dd3a1751c44e0aa93dc (patch)
tree21ea507c9c5796a46b81cd21e46dd8b71205b756
parent4892ae87f21c5483ad856e0ff239b70d3339b0a7 (diff)
downloaddateutil-575884cfef6e719e1cb86dd3a1751c44e0aa93dc.tar.gz
Move building & releasing and testing sections from README to CONTRIBUTING
-rw-r--r--CONTRIBUTING.md30
-rw-r--r--README.rst36
2 files changed, 31 insertions, 35 deletions
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 755379c..029d2a2 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -3,6 +3,7 @@
This document outlines the ways to contribute to `python-dateutil`. This is a fairly small, low-traffic project, so most of the contribution norms (coding style, acceptance criteria) have been developed ad hoc and this document will not be exhaustive. If you are interested in contributing code or documentation, please take a moment to at least review the license section to understand how your code will be licensed.
## Types of contribution
+
### Bug reports
Bug reports are an important type of contribution - it's important to get feedback about how the library is failing, and there's no better way to do that than to hear about real-life failure cases. A good bug report will include:
@@ -31,3 +32,32 @@ The most important thing to include in your pull request are *tests* - please wr
Starting December 1, 2017, all contributions will be assumed to be released under a dual license - the [Apache 2.0 License](https://www.apache.org/licenses/LICENSE-2.0) and the [3-Clause BSD License](https://opensource.org/licenses/BSD-3-Clause) unless otherwise specified in the pull request.
All contributions before December 1, 2017 except those explicitly relicensed, are only under the 3-clause BSD license.
+
+## Building and releasing
+
+When you get the source, it does not contain the internal zoneinfo
+database. To get (and update) the database, run the updatezinfo.py script. Make sure
+that the zic command is in your path, and that you have network connectivity
+to get the latest timezone information from IANA, or from [our mirror of the
+IANA database](https://dateutil.github.io/tzdata/).
+
+Starting with version 2.4.1, all source and binary distributions will be signed
+by a PGP key that has, at the very least, been signed by the key which made the
+previous release. A table of release signing keys can be found below:
+
+Releases | Signing key fingerprint
+-------- | ---------------------------------------------------
+2.4.1- | [6B49 ACBA DCF6 BD1C A206 67AB CD54 FCE3 D964 BEFB]
+
+[6B49 ACBA DCF6 BD1C A206 67AB CD54 FCE3 D964 BEFB]: https://pgp.mit.edu/pks/lookup?op=vindex&search=0xCD54FCE3D964BEFB
+
+## Testing
+
+dateutil has a comprehensive test suite, which can be run simply by running
+`python -m pytest` in the project root. Note that if you don't have the internal
+zoneinfo database, some tests will fail. Apart from that, all tests should pass.
+
+To easily test dateutil against all supported Python versions, you can use
+[tox](https://tox.readthedocs.io/en/latest/).
+
+All GitHub pull requests are automatically tested using travis and appveyor. \ No newline at end of file
diff --git a/README.rst b/README.rst
index 00df42c..e414828 100644
--- a/README.rst
+++ b/README.rst
@@ -109,41 +109,7 @@ It is maintained by:
Our mailing list is available at `dateutil@python.org <https://mail.python.org/mailman/listinfo/dateutil>`_. As it is hosted by the PSF, it is subject to the `PSF code of
conduct <https://www.python.org/psf/codeofconduct/>`_.
-Building and releasing
-======================
-When you get the source, it does not contain the internal zoneinfo
-database. To get (and update) the database, run the updatezinfo.py script. Make sure
-that the zic command is in your path, and that you have network connectivity
-to get the latest timezone information from IANA, or from `our mirror of the
-IANA database <https://dateutil.github.io/tzdata/>`_.
-
-Starting with version 2.4.1, all source and binary distributions will be signed
-by a PGP key that has, at the very least, been signed by the key which made the
-previous release. A table of release signing keys can be found below:
-
-=========== ============================
-Releases Signing key fingerprint
-=========== ============================
-2.4.1- `6B49 ACBA DCF6 BD1C A206 67AB CD54 FCE3 D964 BEFB`_
-=========== ============================
-
-Testing
-=======
-dateutil has a comprehensive test suite, which can be run simply by running
-`python -m pytest` in the project root. Note that if you don't have the internal
-zoneinfo database, some tests will fail. Apart from that, all tests should pass.
-
-To easily test dateutil against all supported Python versions, you can use
-`tox <https://tox.readthedocs.io/en/latest/>`_.
-
-All github pull requests are automatically tested using travis and appveyor.
-
License
=======
-All contributions after December 1, 2017 released under dual license - either `Apache 2.0 License <https://www.apache.org/licenses/LICENSE-2.0>`_ or the `BSD 3-Clause License <https://opensource.org/licenses/BSD-3-Clause>`_. Contributions before December 1, 2017 - except those those explicitly relicensed - are released only under the BSD 3-Clause License.
-
-.. _6B49 ACBA DCF6 BD1C A206 67AB CD54 FCE3 D964 BEFB:
- https://pgp.mit.edu/pks/lookup?op=vindex&search=0xCD54FCE3D964BEFB
-
-
+All contributions after December 1, 2017 released under dual license - either `Apache 2.0 License <https://www.apache.org/licenses/LICENSE-2.0>`_ or the `BSD 3-Clause License <https://opensource.org/licenses/BSD-3-Clause>`_. Contributions before December 1, 2017 - except those those explicitly relicensed - are released only under the BSD 3-Clause License. \ No newline at end of file