Skip to content

Commit c5319d6

Browse files
authored
Merge pull request #227 from zarr-developers/contributing-20180103
Documentation about contributing
2 parents f6e9b64 + e6f328b commit c5319d6

20 files changed

+516
-83
lines changed

.github/CONTRIBUTING.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
Contributing
2+
============
3+
4+
Please see the [project documentation](http://zarr.readthedocs.io/en/stable/contributing.html) for information about contributing to Zarr.
5+

.github/ISSUE_TEMPLATE.md

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
For bug reports, please follow the template below. For enhancement proposals, feel free
2+
to use whatever template makes sense.
3+
4+
#### Minimal, reproducible code sample, a copy-pastable example if possible
5+
6+
```python
7+
# Your code here
8+
9+
```
10+
11+
#### Problem description
12+
13+
Explain why the current behavior is a problem, what the expected output/behaviour
14+
is, and why the expected output/behaviour is a better solution.
15+
16+
#### Version and installation information
17+
18+
Please provide the following:
19+
20+
* Value of ``zarr.__version__``
21+
* Value of ``numcodecs.__version__``
22+
* Version of Python interpreter
23+
* Operating system (Linux/Windows/Mac)
24+
* How Zarr was installed (e.g., "using pip into virtual environment", or "using conda")
25+
26+
Also, if you think it might be relevant, please provide the output from ``pip freeze`` or
27+
``conda env export`` depending on which was used to install Zarr.

.github/PULL_REQUEST_TEMPLATE.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
[Description of PR]
2+
3+
TODO:
4+
* [ ] Add unit tests and/or doctests in docstrings
5+
* [ ] Unit tests and doctests pass locally under Python 3.6 (e.g., run ``tox -e py36`` or
6+
``pytest -v --doctest-modules zarr``)
7+
* [ ] Unit tests pass locally under Python 2.7 (e.g., run ``tox -e py27`` or
8+
``pytest -v zarr``)
9+
* [ ] PEP8 checks pass (e.g., run ``tox -e py36`` or ``flake8 --max-line-length=100 zarr``)
10+
* [ ] Add docstrings and API docs for any new/modified user-facing classes and functions
11+
* [ ] New/modified features documented in docs/tutorial.rst
12+
* [ ] Doctests in tutorial pass (e.g., run ``tox -e py36`` or ``python -m doctest -o NORMALIZE_WHITESPACE -o ELLIPSIS docs/tutorial.rst``)
13+
* [ ] Changes documented in docs/release.rst
14+
* [ ] Docs build locally (e.g., run ``tox -e docs``)
15+
* [ ] AppVeyor and Travis CI passes
16+
* [ ] Test coverage to 100% (Coveralls passes)

LICENSE

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
The MIT License (MIT)
22

3-
Copyright (c) 2015 Alistair Miles
3+
Copyright (c) 2015-2018 Zarr Developers <https://github.com/zarr-developers>
44

55
Permission is hereby granted, free of charge, to any person obtaining a copy
66
of this software and associated documentation files (the "Software"), to deal

README.rst

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,11 +9,11 @@ more information.
99
.. image:: https://readthedocs.org/projects/zarr/badge/?version=latest
1010
:target: http://zarr.readthedocs.io/en/latest/?badge=latest
1111

12-
.. image:: https://travis-ci.org/alimanfoo/zarr.svg?branch=master
13-
:target: https://travis-ci.org/alimanfoo/zarr
12+
.. image:: https://travis-ci.org/zarr-developers/zarr.svg?branch=master
13+
:target: https://travis-ci.org/zarr-developers/zarr
1414

1515
.. image:: https://ci.appveyor.com/api/projects/status/7d4iko59k8hpbbik?svg=true
16-
:target: https://ci.appveyor.com/project/alimanfoo/zarr
16+
:target: https://ci.appveyor.com/project/zarr-developers/zarr
1717

18-
.. image:: https://coveralls.io/repos/github/alimanfoo/zarr/badge.svg?branch=master
19-
:target: https://coveralls.io/github/alimanfoo/zarr?branch=master
18+
.. image:: https://coveralls.io/repos/github/zarr-developers/zarr/badge.svg?branch=master
19+
:target: https://coveralls.io/github/zarr-developers/zarr?branch=master

docs/conf.py

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ def __getattr__(cls, name):
6060

6161
numpydoc_show_class_members = False
6262
numpydoc_class_members_toctree = False
63-
issues_github_path = 'alimanfoo/zarr'
63+
issues_github_path = 'zarr-developers/zarr'
6464

6565
# Add any paths that contain templates here, relative to this directory.
6666
templates_path = ['_templates']
@@ -78,8 +78,8 @@ def __getattr__(cls, name):
7878

7979
# General information about the project.
8080
project = 'zarr'
81-
copyright = '2016, Alistair Miles'
82-
author = 'Alistair Miles'
81+
copyright = '2018, Zarr Developers'
82+
author = 'Zarr Developers'
8383

8484
# The version info for the project you're documenting, acts as replacement for
8585
# |version| and |release|, also used in various other places throughout the
@@ -258,7 +258,7 @@ def __getattr__(cls, name):
258258
# author, documentclass [howto, manual, or own class]).
259259
latex_documents = [
260260
(master_doc, 'zarr.tex', 'zarr Documentation',
261-
'Alistair Miles', 'manual'),
261+
'Zarr Developers', 'manual'),
262262
]
263263

264264
# The name of an image file (relative to this directory) to place at the top of

0 commit comments

Comments
 (0)