Skip to content
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

Docs maintenance #52

Merged
merged 9 commits into from
Nov 19, 2024
Merged

Docs maintenance #52

merged 9 commits into from
Nov 19, 2024

Conversation

douglatornell
Copy link
Member

@douglatornell douglatornell commented Nov 19, 2024

This PR updates the pre-commit, readthedocs, and development environment configurations and updates documentation for the MoaceanParcels project.

  • Updated Python version dependencies in various environment files.
  • Aligned some package versions across multiple configuration files for consistency.
  • Updated references to intersphinx mappings and kernel documentation links.
  • Removed redundant SPDX-License identifier.
  • Fixed formatting issues in the Sphinx documentation configuration.
  • Updated pre-commit hooks and black dependencies to latest versions.
  • Changed ReadTheDocs configuration to use latest versions of Ubuntu and mambaforge.
  • Updated sphinx versions, and theme to the latest versions.
  • Updated documentation text and example notebook references.

@douglatornell douglatornell added documentation Improvements or additions to documentation maintenance Codebase & Repo maintenace labels Nov 19, 2024
@douglatornell douglatornell added this to the v22.1 milestone Nov 19, 2024
Upgraded the OS to Ubuntu 24.04 and updated the Python toolchain to
mambaforge-23.11 in the .readthedocs.yaml file. This ensures
compatibility with the latest environment settings available on
readthedocs.
Updated Sphinx and optional dependencies packages pinned versions in
`environment-dev.yaml`, `environment-test.yaml`, and `environment-rtd.yaml` in
preparation for Python 3.13 environment.
Updated the black formatter for blacken-docs from version 21.10b0 to 24.10.0.
This change ensures compatibility with the latest version of black and avoids
a version conflict problem during setup of the the pre-commit virtualenv.
Change the intersphinx mapping for OceanParcels to its new documentation URL.
This ensures references to OceanParcels documentation are correctly resolved
during the build process.
Changed the documentation reference link in the Stokes_drift kernel to point
to the correct section in the example notebooks. This ensures users can find
more detailed usage examples without any confusion.
Changed the documentation reference link in the Stokes_drift kernel to point
to the correct section in the example notebooks. This ensures users can find
more detailed usage examples without any confusion.
Changed outdated Conda links in `docs/pkg_development.rst` and
`docs/installation.rst` to their current URLs. This ensures users are directed
to the most accurate and up-to-date documentation.
Updated Sphinx build and linkcheck commands example outputs.
@douglatornell douglatornell merged commit 4b1faf2 into main Nov 19, 2024
5 checks passed
@douglatornell douglatornell deleted the docs-maint branch November 19, 2024 23:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation maintenance Codebase & Repo maintenace
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant