Towncrier 25.8.0

[adiroiban]

towncrier 25.8.0 (2025-08-30)

Features

• Support was added for Mercurial SCM. (#394 <https://github.com/twisted/towncrier/issues/394>_)
• The towncrier check command now has a --staged flag to inspect the files staged for commit when checking for a news fragment: useful in a pre-commit hook (#676 <https://github.com/twisted/towncrier/issues/676>_)
• When used with an pyproject.toml file, when no explicit values are
  defined for [tool.towncrier.name|package] they will now fallback to
  the value of [project.name]. (#687 <https://github.com/twisted/towncrier/issues/687>_)
• More simple configuration for Keep a Changelog style changelogs (#691 <https://github.com/twisted/towncrier/issues/691>_)
• Added support for Python 3.13 and removed support for Python 3.8. (#700 <https://github.com/twisted/towncrier/issues/700>_)

Bugfixes

• Multi-line newsfragments that ends with a code block will now have a newline inserted before appending the link to the issue, to avoid breaking formatting. (#614 <https://github.com/twisted/towncrier/issues/614>_)
• Markdown header level is correctly inferred from title_format. (#695 <https://github.com/twisted/towncrier/issues/695>_)

Improved Documentation

• The documentation RST source files are now included in the sdist package. (#672 <https://github.com/twisted/towncrier/issues/672>_)
• Refactor the default markdown template to make it easier to understand, extend, and customize. (#706 <https://github.com/twisted/towncrier/issues/706>_)

Deprecations and Removals

• When no sections are present,
  the default Markdown template now renders the category headers as H2.
  In previous versions it was rendered as H3. (#663 <https://github.com/twisted/towncrier/issues/663>_)

Misc

• #667 <https://github.com/twisted/towncrier/issues/667>, #669 <https://github.com/twisted/towncrier/issues/669>, #679 <https://github.com/twisted/towncrier/issues/679>, #680 <https://github.com/twisted/towncrier/issues/680>, #682 <https://github.com/twisted/towncrier/issues/682>, #701 <https://github.com/twisted/towncrier/issues/701>, #702 <https://github.com/twisted/towncrier/issues/702>, #713 <https://github.com/twisted/towncrier/issues/713>

---

This discussion was created from the release Towncrier 25.8.0.