Skip to content

Adding no gerunds in titles Suggestion rule#1008

Open
aireilly wants to merge 2 commits into
redhat-documentation:mainfrom
aireilly:no-gerunds
Open

Adding no gerunds in titles Suggestion rule#1008
aireilly wants to merge 2 commits into
redhat-documentation:mainfrom
aireilly:no-gerunds

Conversation

@aireilly
Copy link
Copy Markdown
Member

@aireilly aireilly commented Feb 4, 2026

Red Hat docs guidance is now not to use gerunds in titles, in favor of the imperative form.

This suggestion rule uses a tengo script replace action to suggest a correct replacement.

image

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Feb 4, 2026

⚡️ Deploying PR Preview...

@aireilly aireilly force-pushed the no-gerunds branch 3 times, most recently from babcdf9 to 7eaed84 Compare February 4, 2026 16:17
Copy link
Copy Markdown
Contributor

@jeana-redhat jeana-redhat left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oops I thought I hit submit on my comment but I guess it started a review

Comment thread .vale/styles/RedHat/NoGerundsInTitles.yml Outdated
@aireilly
Copy link
Copy Markdown
Member Author

lol forgot about this but I guess we can push the button now?

Signed-off-by: Aidan Reilly <aireilly@redhat.com>

Signed-off-by: Aidan Reilly <aireilly@redhat.com>

rh-pre-commit.version: 2.3.2
rh-pre-commit.check-secrets: ENABLED
@aireilly aireilly force-pushed the no-gerunds branch 2 times, most recently from 9c465e4 to c4b7230 Compare April 23, 2026 08:24
Add exceptions list for non-gerund words ending in -ing (String, Spring,
Existing, Underlying, etc.) that were incorrectly flagged. Rewrite the
Tengo suggestion script with a lookup table for doubled-consonant verbs
(Running→Run not Runn) and silent-e verbs (Writing→Write not Writ), plus
three new safe suffix patterns (-ving→-ve, -cing→-ce, -ling→-le). Expand
test fixtures from 13 to 42 invalid and 14 to 31 valid headings.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Signed-off-by: Aidan Reilly <aireilly@redhat.com>

Signed-off-by: Aidan Reilly <aireilly@redhat.com>

rh-pre-commit.version: 2.3.2
rh-pre-commit.check-secrets: ENABLED
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