Files
py-libp2p/newsfragments
paschal533 bb9c8235a8 Add Windows setup and reorganize dependencies by OS in contributing.rst
Moved dependencies into Linux, macOS, and Windows sections per Paul's suggestion. Fixed reST formatting (blank lines, title underlines) to resolve Sphinx warnings from ReadTheDocs CI. Tested on Windows 10 (Python 3.11.0).
2025-04-11 18:28:38 -06:00
..
2025-04-11 18:01:57 -06:00
2023-10-04 13:32:07 -06:00
2023-10-04 13:32:07 -06:00

This directory collects "newsfragments": short files that each contain a snippet of ReST-formatted text that will be added to the next release notes. This should be a description of aspects of the change (if any) that are relevant to users. (This contrasts with the commit message and PR description, which are a description of the change as relevant to people working on the code itself.)

Each file should be named like <ISSUE>.<TYPE>.rst, where <ISSUE> is an issue number, and <TYPE> is one of:

  • breaking
  • bugfix
  • deprecation
  • docs
  • feature
  • internal
  • misc
  • performance
  • removal

So for example: 123.feature.rst, 456.bugfix.rst

If the PR fixes an issue, use that number here. If there is no issue, then open up the PR first and use the PR number for the newsfragment.

Note that the towncrier tool will automatically reflow your text, so don't try to do any fancy formatting. Run towncrier build --draft to get a preview of what the release notes entry will look like in the final release notes.