Skip to content

Conversation

@LittleCoinCoin
Copy link
Member

Adapting the configuration of semantic-release to accomodate a prefered location of the CHANGELOG in the /docs. Also made changes to update the version number in the pyproject.toml automatically.

Dependency Management:

  • Leverage the "semantic-release-poetry-plugin" to up the version number in pyproject.toml automatically
  • Ensured the Poetry plugin is installed during Node dependency setup in CI.

Documentation Refactoring & Reference Updates:

  • Moved CONTRIBUTING.md and related contribution guides from the root to the docs directory, updating all references in README.md, docs/index.md, and internal documentation to point to the new locations. [1] [2] [3] [4]
  • Removed the old docs/articles/devs/how_to_contribute.md file, consolidating contribution guidelines under docs/CONTRIBUTING.md.
  • Added a direct link to the changelog in docs/index.md for easier access to release history.

Release Automation & Changelog Management:

  • Updated .releaserc.json to generate and store changelogs in docs/CHANGELOG.md instead of the project root, and include this file as a release asset.
  • Integrated the Poetry plugin (@covage/semantic-release-poetry-plugin) into semantic-release configuration for automated Python package versioning. [1] [2]
  • Removed the obsolete CHANGELOG.md from the root directory, aligning with the new changelog location.

Minor Workflow Cleanup:

    • Removed unnecessary debug steps from the GitHub Actions workflow for semantic-release, streamlining the release process.
  • Removed the unused run-name property from the semantic-release GitHub Actions workflow for clarity.

LittleCoinCoin added 5 commits August 26, 2025 20:50
As it seems we fixed the issue on release going through as expected, we clean up the workflow
We are also removing the old `how_to_contribute.md` in favor of the new `CONTRIBUTING.md`
- We update the settings of `semantic-release` to output the changelog in the `/docs` directory.
- We also add a link from the top-level `index.md` of the docs to reference the CHANGELOG.md
- We remove the CHANGELOG generated in the previous auto-releave because the version number was wrong.
To update the version in the `pyproject.toml`.
Adding the command to install the plugin in the workflow.
From v0.1.0-development to v0.2.0-development allowed to leverage the field `[project].version` in the `pyproject.toml` instead of the code looking for the poetry quivalent.
@LittleCoinCoin LittleCoinCoin merged commit 4ff1c29 into main Aug 26, 2025
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants