-
Notifications
You must be signed in to change notification settings - Fork 224
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
doc: Move compatibility table from README to separate file #2862
Changes from 22 commits
0b67f9c
e453d15
e7d5631
06941b5
84f02a9
7929106
e14c198
bfff5d0
e845c6b
446857c
6bf8fa2
fecd5a9
7ed6392
0761c2a
f138237
45a82cc
41fe62a
8c0bd1a
0e09afd
ff1da6f
3ba460a
b4ff03e
1449f68
315595b
c9c1dd7
17a925f
8dfe0a3
7fd4577
63eaa06
2b70ea7
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,105 @@ | ||
Minimum Supported GMT/Python/NumPy Versions | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I'm debating if we should rename the file to There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I think I perfer There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Done in c9c1dd7. |
||
------------------------------------------- | ||
|
||
PyGMT has adopted `NEP29 <https://numpy.org/neps/nep-0029-deprecation_policy>`__ | ||
alongside the rest of the Scientific Python ecosystem, and therefore supports: | ||
|
||
* All minor versions of Python released 42 months prior to the project, and at minimum | ||
the two latest minor versions. | ||
* All minor versions of NumPy released in the 24 months prior to the project, and at | ||
minimum the last three minor versions. | ||
|
||
.. list-table:: | ||
:widths: 25 30 15 20 15 | ||
:header-rows: 1 | ||
|
||
* - PyGMT Version | ||
- Documentation | ||
- GMT | ||
- Python | ||
- NumPy | ||
* - `Dev <https://github.com/GenericMappingTools/pygmt/milestones>`_ (upcoming release) | ||
- `Dev Documentation <https://www.pygmt.org/dev>`_ (reflects `main branch <https://github.com/GenericMappingTools/pygmt>`_) | ||
- >=6.3.0 | ||
- >=3.9 | ||
- >=1.23 | ||
* - `v0.10.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.10.0>`_ (latest release) | ||
- `v0.10.0 Documentation <https://www.pygmt.org/v0.10.0>`_ | ||
- >=6.3.0 | ||
- >=3.9 | ||
- >=1.22 | ||
* - `v0.9.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.9.0>`_ | ||
- `v0.9.0 Documentation <https://www.pygmt.org/v0.9.0>`_ | ||
- >=6.3.0 | ||
- >=3.8 | ||
- >=1.21 | ||
* - `v0.8.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.8.0>`_ | ||
- `v0.8.0 Documentation <https://www.pygmt.org/v0.8.0>`_ | ||
- >=6.3.0 | ||
- >=3.8 | ||
- >=1.20 | ||
* - `v0.7.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.7.0>`_ | ||
- `v0.7.0 Documentation <https://www.pygmt.org/v0.7.0>`_ | ||
- >=6.3.0 | ||
- >=3.8 | ||
- >=1.20 | ||
* - `v0.6.1 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.6.1>`_ | ||
- `v0.6.1 Documentation <https://www.pygmt.org/v0.6.1>`_ | ||
- >=6.3.0 | ||
- >=3.8 | ||
- >=1.19 | ||
* - `v0.6.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.6.0>`_ | ||
- `v0.6.0 Documentation <https://www.pygmt.org/v0.6.0>`_ | ||
- >=6.3.0 | ||
- >=3.8 | ||
- >=1.19 | ||
* - `v0.5.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.5.0>`_ | ||
- `v0.5.0 Documentation <https://www.pygmt.org/v0.5.0>`_ | ||
- >=6.2.0 | ||
- >=3.7 | ||
- >=1.18 | ||
* - `v0.4.1 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.4.1>`_ | ||
- `v0.4.1 Documentation <https://www.pygmt.org/v0.4.1>`_ | ||
- >=6.2.0 | ||
- >=3.7 | ||
- >=1.17 | ||
* - `v0.4.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.4.0>`_ | ||
- `v0.4.0 Documentation <https://www.pygmt.org/v0.4.0>`_ | ||
- >=6.2.0 | ||
- >=3.7 | ||
- >=1.17 | ||
* - `v0.3.1 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.3.1>`_ | ||
- `v0.3.1 Documentation <https://www.pygmt.org/v0.3.1>`_ | ||
- >=6.1.1 | ||
- >=3.7 | ||
- | ||
* - `v0.3.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.3.0>`_ | ||
- `v0.3.0 Documentation <https://www.pygmt.org/v0.3.0>`_ | ||
- >=6.1.1 | ||
- >=3.7 | ||
- | ||
* - `v0.2.1 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.2.1>`_ | ||
- `v0.2.1 Documentation <https://www.pygmt.org/v0.2.1>`_ | ||
- >=6.1.1 | ||
- >=3.6 | ||
- | ||
* - `v0.2.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.2.0>`_ | ||
- `v0.2.0 Documentation <https://www.pygmt.org/v0.2.0>`_ | ||
- >=6.1.1 | ||
- 3.6 - 3.8 | ||
- | ||
* - `v0.1.2 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.1.2>`_ | ||
- `v0.1.2 Documentation <https://www.pygmt.org/v0.1.2>`_ | ||
- >=6.0.0 | ||
- 3.6 - 3.8 | ||
- | ||
* - `v0.1.1 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.1.1>`_ | ||
- `v0.1.1 Documentation <https://www.pygmt.org/v0.1.1>`_ | ||
- >=6.0.0 | ||
- 3.6 - 3.8 | ||
- | ||
* - `v0.1.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.1.0>`_ | ||
- `v0.1.0 Documentation <https://www.pygmt.org/v0.1.0>`_ | ||
- >=6.0.0 | ||
- 3.6 - 3.8 | ||
- |
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -11,7 +11,8 @@ | |
</div> | ||
|
||
.. include:: ../README.rst | ||
:start-after: placeholder-for-doc-index | ||
:start-after: doc-index-start-after | ||
:end-before: doc-index-end-before | ||
|
||
.. toctree:: | ||
:maxdepth: 2 | ||
|
@@ -39,6 +40,7 @@ | |
|
||
api/index.rst | ||
changes.md | ||
Minimum Supported Versions <compatibility.rst> | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. The name "Minimum Supported GMT/Python/NumPy Versions" are too long to fit the sidebar. |
||
|
||
.. toctree:: | ||
:maxdepth: 2 | ||
|
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -83,12 +83,16 @@ We recommend following the instructions further on to install GMT 6. | |
|
||
PyGMT requires the following libraries to be installed: | ||
|
||
- [numpy](https://numpy.org) (>= 1.23) | ||
- [numpy](https://numpy.org) | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. After adopting SPEC 0 (#2863), we will also need to pin pandas and xarray. Removing the pinned version from the installation guides because most users don't care about them. For anyone who cares about the versions, we provide the link to the "compatibility table". |
||
- [pandas](https://pandas.pydata.org) | ||
- [xarray](https://xarray.dev/) | ||
- [netCDF4](https://unidata.github.io/netcdf4-python) | ||
- [packaging](https://packaging.pypa.io) | ||
|
||
:::{note} | ||
For the minimum supported versions of the dependencies, please see {doc}`compatibility`. | ||
::: | ||
|
||
The following are optional dependencies: | ||
|
||
- [IPython](https://ipython.org): For embedding the figures in Jupyter notebooks (recommended). | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This section is not shown on the index page (https://pygmt-dev--2862.org.readthedocs.build/en/2862/index.html) but is shown in the README file.