Update GitHub Actions and ReadTheDocs workflows to use modern conda setup
The documentation workflow was failing due to deprecated Mambaforge usage. This PR updates all GitHub Actions workflows and ReadTheDocs configuration to use modern, supported tooling.
Changes Made
๐ง Fixed Deprecated Mambaforge Usage
- Updated
docs.yamlworkflow to useminiforge-variant: Miniforge3instead of deprecatedMambaforge - Updated
gh-ci.yamlworkflow to useminiforge-variant: Miniforge3instead of deprecatedMambaforge - Updated
readthedocs.yamlto usepython: "3.11"instead of deprecatedpython: "mambaforge-22.9"
๐ฆ Updated GitHub Actions Versions
- Updated
actions/checkout@v3โactions/checkout@v4(consistency fix) - Updated
actions/setup-python@v4โactions/setup-python@v5(latest stable) - Updated
peaceiris/actions-gh-pages@v3โpeaceiris/actions-gh-pages@v4(latest stable)
๐งน Repository Cleanup
- Added
docs/html/to.gitignoreto exclude documentation build artifacts
Testing
- โ Successfully built documentation locally using the updated conda environment
- โ Validated all YAML files for syntax correctness
- โ Verified the conda environment setup works with the new Miniforge3 configuration
Before/After
Before: Workflows failing with deprecation warnings:
Warning: Future Miniforge releases will NOT build Mambaforge installers.
We advise you switch to Miniforge at your earliest convenience.
After: Workflows use modern, supported conda tooling that will continue to work long-term.
These changes ensure the documentation builds will continue to work reliably without deprecation warnings.
Fixes #77.
[!WARNING]
Firewall rules blocked me from connecting to one or more addresses
I tried to connect to the following addresses, but was blocked by firewall rules:
docs.mdanalysis.org
- Triggering command:
/usr/share/miniconda/envs/propkatrajdocs/bin/python3.13 /usr/share/miniconda/envs/propkatrajdocs/bin/sphinx-build -T -E --keep-going -b html -D language=en sphinx html(dns block)docs.python.org
- Triggering command:
/usr/share/miniconda/envs/propkatrajdocs/bin/python3.13 /usr/share/miniconda/envs/propkatrajdocs/bin/sphinx-build -T -E --keep-going -b html -D language=en sphinx html(dns block)numpy.org
- Triggering command:
/usr/share/miniconda/envs/propkatrajdocs/bin/python3.13 /usr/share/miniconda/envs/propkatrajdocs/bin/sphinx-build -T -E --keep-going -b html -D language=en sphinx html(dns block)pandas.pydata.org
- Triggering command:
/usr/share/miniconda/envs/propkatrajdocs/bin/python3.13 /usr/share/miniconda/envs/propkatrajdocs/bin/sphinx-build -T -E --keep-going -b html -D language=en sphinx html(dns block)If you need me to access, download, or install something from one of these locations, you can either:
- Configure Actions setup steps to set up my environment, which run before the firewall is enabled
- Add the appropriate URLs or hosts to my firewall allow list
๐ฌ Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.
Codecov Report
All modified and coverable lines are covered by tests :white_check_mark:
Project coverage is 98.30%. Comparing base (
bbd5735) to head (3bc04f8).
Additional details and impacted files
@@ Coverage Diff @@
## main #78 +/- ##
=======================================
Coverage 98.30% 98.30%
=======================================
Files 2 2
Lines 59 59
=======================================
Hits 58 58
Misses 1 1
:umbrella: View full report in Codecov by Sentry.
:loudspeaker: Have feedback on the report? Share it here.
:rocket: New features to boost your workflow:
- :snowflake: Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
@copilot status checks are still failing for some windows versions. How can this be fixed?