Skip to content

Conversation

@patchback
Copy link

@patchback patchback bot commented Nov 10, 2025

This is a backport of PR #3028 as merged into devel (b2a6c41).

This PR seeks to increase the clarity and scope of the "Making your PR Merge Worthy"
section of the The Ansible Development Cycle page.

It updates the wording of the changelog section to fix some small grammar issues and
includes a link to the RST specification.

This PR also adds a section "Testing PRs" with links to information on Integration and
Unit tests because one of the most common comments on PRs is some variation of "Can you write some tests for this?"

* Fix grammar and add documentation link

 - Fix the number-verb agreement in a bullet point
 - Add a link to the RST spec and re-word the embedding

* Add small section on testing

* Edit title for Changelog section

I find the title "Creating changelog fragments" too similar to "Creating a changelog fragment".

* Update title of test section and reorganize sentences

* Fix spelling of preferred

* Add words for clarity

* Capitalize YAML and RST

Capitalizing these helps to distinguish
between the yaml/rst format and file extension.

* Fix line breaks in test section

Co-authored-by: 🇺🇦 Sviatoslav Sydorenko (Святослав Сидоренко) <[email protected]>

* Rephrase testing section

* Fix period clickability

Co-authored-by: 🇺🇦 Sviatoslav Sydorenko (Святослав Сидоренко) <[email protected]>

---------

Co-authored-by: 🇺🇦 Sviatoslav Sydorenko (Святослав Сидоренко) <[email protected]>
(cherry picked from commit b2a6c41)
@oraNod oraNod merged commit 9f769b6 into stable-2.18 Nov 10, 2025
10 of 11 checks passed
@oraNod oraNod deleted the patchback/backports/stable-2.18/b2a6c417f47506505099767c2643ed42bdd8b2d7/pr-3028 branch November 10, 2025 20:02
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