Release v1.1.0

Author: mmcky

CHANGELOG.md

@@ -1,6 +1,6 @@
 # Changelog
 
-## [v1.1.0](https://github.com/executablebooks/sphinx-exercise/tree/v1.1.0) (TBD)
+## [v1.1.0](https://github.com/executablebooks/sphinx-exercise/tree/v1.1.0) (2025-10-22)
 
 ### New ✨
 
@@ -10,9 +10,12 @@
 
 ### Improved 👌
 
+- **Updated test suite for Python 3.11-3.13 and Sphinx 6-8 compatibility** ([#79](https://github.com/executablebooks/sphinx-exercise/pull/79))
+- **Migrated from os.path to pathlib.Path throughout codebase for modern Python best practices**
 - Reorganized and expanded translation files with alphabetical sorting
 - Enhanced translation documentation with comprehensive guides
 - Updated README and documentation to highlight internationalization features
+- Fixed README badges to reference main branch instead of master
 
 ### Documentation 📚
 
@@ -22,6 +25,15 @@
 - Created releases documentation structure in `docs/releases/`
 - Added Copilot instructions for project maintenance
 
+### Testing Infrastructure 🧪
+
+- Added support for Python 3.11, 3.12, and 3.13
+- Added support for Sphinx 6, 7, and 8
+- Full test matrix: 9 combinations (3 Python versions × 3 Sphinx versions)
+- All 110 tests passing across all supported versions
+- Regenerated test fixtures for Sphinx 6 and 7 compatibility
+- Normalized image hashes for cross-platform test stability
+
 
 ## [v1.0.1](https://github.com/executablebooks/sphinx-exercise/tree/v1.0.1) (2024-XX-XX)
 

RELEASE.md

@@ -54,37 +54,50 @@ git push origin main
 git push origin v1.1.0
 ```
 
-### 4. Create GitHub Release
+### 4. Automated PyPI Publication
+
+After pushing the tag, the GitHub Actions workflow will automatically:
+- Run all tests (pre-commit, pytest, docs)
+- Build the distribution packages
+- Publish to PyPI using the `PYPI_KEY` secret
+
+You can monitor the progress at:
+https://github.com/executablebooks/sphinx-exercise/actions
+
+### 5. Create GitHub Release
+
+Once the workflow completes successfully:
 
 1. Go to https://github.com/executablebooks/sphinx-exercise/releases/new
 2. Select tag: `v1.1.0`
 3. Release title: `v1.1.0 - Internationalization Support`
 4. Description: Copy content from `docs/source/releases/v1.1.0.md`
 5. Click "Publish release"
 
-### 5. Publish to PyPI
-
-```bash
-# Clean previous builds
-rm -rf dist/ build/ *.egg-info
-
-# Build distribution
-python -m build
-
-# Upload to PyPI (requires PyPI credentials)
-python -m twine upload dist/*
-```
-
 ### 6. Update Documentation
 
 The documentation should automatically build from the new tag on ReadTheDocs. Verify at:
 https://ebp-sphinx-exercise.readthedocs.io/en/latest/
 
 ### 7. Post-Release
 
-1. Update `docs/source/releases/index.md` to include v1.1.0
-2. Create new "Unreleased" section in CHANGELOG.md for future changes
-3. Announce release on relevant channels
+1. Verify the package is available on PyPI: https://pypi.org/project/sphinx-exercise/
+2. Update `docs/source/releases/index.md` to include v1.1.0
+3. Create new "Unreleased" section in CHANGELOG.md for future changes
+4. Announce release on relevant channels
+
+## Automated Release Process
+
+This project uses GitHub Actions to automatically publish to PyPI when a version tag is pushed:
+
+1. **Triggering**: The workflow is triggered when a tag matching `v*` is pushed
+2. **Testing**: All tests (pre-commit, pytest, documentation) must pass
+3. **Building**: The workflow builds the distribution packages using `python -m build`
+4. **Publishing**: Packages are automatically published to PyPI using the `PYPI_KEY` secret
+
+**Important**: Ensure the `PYPI_KEY` secret is configured in the repository settings with a valid PyPI API token.
+
+The workflow definition can be found in `.github/workflows/ci.yml` under the `publish` job.
 
 ## Version Numbering
 

sphinx_exercise/__init__.py

@@ -7,7 +7,7 @@
 :license: MIT, see LICENSE for details.
 """
 
-__version__ = "1.0.1"
+__version__ = "1.1.0"
 
 from pathlib import Path
 from typing import Any, Dict, Set, Union, cast