docs: update README Python prereqs; add dev guides for bumping Python and SymPy (#571)#572
Merged
Merged
Conversation
utensil
reviewed
Apr 2, 2026
Member
utensil
left a comment
utensil
left a comment
There was a problem hiding this comment.
Thanks for this — the doc is well-organized and the version policy is clearly stated.
There's a merge conflict in the making between this PR and #574: both add a "Developer guides" toctree block to doc/index.rst starting from the same base on master. If they merge independently Sphinx will produce two separate "Developer guides" sections in the sidebar. Whichever merges second should rebase and consolidate both into a single toctree block.
setup.py still has python_requires='>=3.6' and classifiers only up to 3.11, so the PyPI version badge won't reflect 3.12 until that's updated. Worth doing in this PR since the README already claims 3.10-3.12 support.
test_requirements.txt is missing from the files-to-update table — adding packaging there was part of the 3.12 bump (needed to replace distutils), so it belongs in the checklist.
utiberious
added a commit
to utiberious/galgebra
that referenced
this pull request
Apr 2, 2026
- Remove Developer guides toctree from doc/index.rst; pygae#574 owns it with the full three-entry block to avoid duplicate sidebar sections - Fix setup.py: python_requires>=3.10, drop 3.8/3.9 classifiers, add 3.12 - Add test_requirements.txt to the files-to-update table in bumping-python.md
- Remove Developer guides toctree from doc/index.rst; pygae#574 owns it with the full three-entry block to avoid duplicate sidebar sections - Fix setup.py: python_requires>=3.10, drop 3.8/3.9 classifiers, add 3.12 - Add test_requirements.txt to the files-to-update table in bumping-python.md
utiberious
force-pushed
the
fix/issue-571-python-docs
branch
from
27c455c to
a5d9b83
Compare
- Remove version policy cross-reference to bumping-sympy.md - Inline the full tracking issue pattern description instead of deferring to bumping-sympy.md - Use bare flake8/pytest to match CI
utensil
pushed a commit
that referenced
this pull request
Apr 3, 2026
* docs: add 0.6.1 changelog entries Covers: Mlt component-expression constructor (#578/#580), is_blade null fix (#537), Macdonald PDF update (#577), dev guides (#572/#574), SymPy 1.13 notebook refresh (#570), Lt ImmutableDenseMatrix fix (#569), Python 3.10-3.12 CI (#565). * docs(changelog): fix is_blade entry reference from issue to PR The is_blade entry incorrectly referenced issue 537 but should reference PR 582 to match the convention used in other entries. --------- Co-authored-by: utiberious <utiberious@users.noreply.github.com>
utensil
pushed a commit
that referenced
this pull request
Apr 4, 2026
…se date * docs(changelog): add 0.6.1 entries for #587, #589, #590; update release date Adds changelog entries for three PRs merged after the initial 0.6.1 changelog write (#583): - #590 / #576: SymPy 1.13 TR3 performance workaround in curvi_linear_latex - #589 / #588: Step 0 added to release-process runbook - #587 / #586: pyproject.toml migration (PEP 517/621) Also updates the 0.6.1 release date from 2026.04.02 to 2026.04.04 (actual merge date of the last included PR). Addresses the changelog TODOs listed in release issue #588. * docs(changelog): expand 0.6.1 entries for #570, #572, #585 - #570: add ZeroDivisionError fix in Mv._latex, validate_nb_refresh.py, bumping-sympy.md guide, sympy pin bump, and issue #566 reference - #572: remove bumping-sympy.md (belongs to #570, not #572) - #585: add missing entry for is_blade test expansion * docs(changelog): address review — fix tag, ordering, and 570 ZDE split - #590: :support: → 🐛 (restores broken CI, not just a workaround) - #585: move to correct descending-number position (between #587 and #580) - #570: split ZeroDivisionError fix into separate 🐛`570` entry so it leads clearly; :support:`570` retains notebook refresh / tooling content
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #571.
Changes
README.mdPython >= 3.8→>= 3.10 (3.10, 3.11, 3.12 tested via CI)setup.pypython_requiresbumped to>=3.10doc/dev/bumping-python.md(new)Covers: version policy (drop EOL, add recent-but-not-latest), files to update (including
test_requirements.txt), CI action version audit, Python 3.12 compat audit (distutils, escape sequences), local testing setup, and the tracking issue pattern.The doc uses
.mdfor content with a thin.rstmdincludewrapper for Sphinx, consistent with existing practice.