Skip to content

Commit 15c9e2b

Browse files
committed
Update README/docs related to contributing and level of service
* NSIDC user services has no capacity to officially support `iceflow` until at least August. In the meantime, we want to respond to community-submitted issues and PRs as time allows, but want to still make it clear that this is not a fully-supported product. * Move `CONTRIBUTING.md` to doc/ as a new page in RTD and reference it in the "Level of Support" section.
1 parent ff3bae4 commit 15c9e2b

File tree

3 files changed

+20
-8
lines changed

3 files changed

+20
-8
lines changed

README.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,8 +26,17 @@ access laser altimetry data from (pre-)Operation Icebridge and ICESat datasets.
2626

2727
## Level of Support
2828

29-
- This repository is not actively supported by NSIDC but we welcome issue
30-
submissions and pull requests in order to foster community contribution.
29+
This repository is not actively supported by NSIDC but we welcome issue
30+
submissions and pull requests in order to foster community contribution. We will
31+
strive to respond to contributions in a timely manner, but make no guarantees.
32+
33+
If you discover any problems or bugs, please submit an
34+
[Issue](https://github.com/nsidc/iceflow/issues/new).
35+
36+
If you would like to contribute to this repository, you may fork the repository
37+
and submit a pull request. See our
38+
[contributing documentation](https://iceflow.readthedocs.io/en/latest/contributing.html)
39+
for more information about how to contribute to `iceflow`.
3140

3241
See the [LICENSE](./LICENSE) for details on permissions and warranties. Please
3342
contact [email protected] for more information.

CONTRIBUTING.md renamed to docs/contributing.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,11 @@
1+
# Contributing
2+
13
See the [Scientific Python Developer Guide][spc-dev-intro] for a detailed
24
description of best practices for developing scientific packages.
35

46
[spc-dev-intro]: https://learn.scientific-python.org/development/
57

6-
# Setting up a development environment
8+
## Setting up a development environment
79

810
You can set up a development environment with `conda` or your environment
911
manager of choice:
@@ -14,7 +16,7 @@ conda activate iceflow-dev
1416
pip install --editable .[dev]
1517
```
1618

17-
# Pre-commit
19+
## Pre-commit
1820

1921
You should prepare pre-commit, which will help you by checking that commits pass
2022
required checks:
@@ -26,7 +28,7 @@ pre-commit install # Will install a pre-commit hook into the git repo
2628
You can also/alternatively run `pre-commit run` (changes only) or
2729
`pre-commit run --all-files` to check without installing the hook.
2830

29-
# Common tasks
31+
## Common tasks
3032

3133
Common dev tasks are handled by [invoke](https://www.pyinvoke.org/). To see
3234
available tasks:
@@ -40,7 +42,7 @@ Available tasks:
4042
test.typecheck (test.mypy) Run mypy typechecking.
4143
```
4244

43-
# Jupyter Notebooks
45+
## Jupyter Notebooks
4446

4547
There are Jupyter Notebooks showing `iceflow` functionality under `notebooks/`.
4648

@@ -64,7 +66,7 @@ changes, clear all outputs.
6466
See below for information about adding rendered versions of notebooks to
6567
ReadTheDocs.
6668

67-
# Documentation
69+
## Documentation
6870

6971
This project uses `sphinx` to generate documentation. To work on the docs,
7072
install the dependencies:
@@ -97,7 +99,7 @@ the main, public-facing documentation site.
9799
> `notebooks/generate_rendered_notebooks_for_docs.sh` for how to add new
98100
> rendered notebooks to the docs.
99101
100-
# Releasing
102+
## Releasing
101103

102104
To release a new version of the software, first update the CHANGELOG.md to
103105
reflect the version you plan to release. Then, bump the version with

docs/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@
88
getting-started.md
99
iceflow-example.ipynb
1010
iceflow-with-icepyx.ipynb
11+
contributing.md
1112
API Docs <api/nsidc>
1213
LICENSE
1314
```

0 commit comments

Comments
 (0)