Skip to content

docs: define and remove "AI-generated phrasing"#107

Merged
yeoldegrove merged 11 commits into
mainfrom
docs/humanize
Jul 14, 2026
Merged

docs: define and remove "AI-generated phrasing"#107
yeoldegrove merged 11 commits into
mainfrom
docs/humanize

Conversation

@yeoldegrove

Copy link
Copy Markdown
Contributor

What this PR does / why we need it:

This PR defines and removes "AI-generated phrasing". Definitions what qualifies at such phrasing as documented.
The removal of the phrases was done via the documentation-humanize workflow and skill.

…ed phrasing guidance

Add 'AI-generated phrasing to avoid' subsection under Style & Language,
listing the eight banned-pattern categories (HYPE-OPEN, TRANS-BLOAT, PROMO,
HEDGE, PRONOUN-OVERREACH, EM-DASH-DRAMA, RHETQ, CANONICAL-LINT) with
one-line before/after examples each.

Add checklist item under Core Markers:
  No AI-tell phrasing (hype openers, transitional bloat, promotional
  flourish, hedging, rhetorical-question openers)
Rules: CANONICAL-LINT (1), HYPE-OPEN (2)
…-generated phrasing

Rules: CANONICAL-LINT (1)
…ed phrasing guidance

Add 'AI-generated phrasing to avoid' subsection under Style & Language,
listing the eight banned-pattern categories (HYPE-OPEN, TRANS-BLOAT, PROMO,
HEDGE, PRONOUN-OVERREACH, EM-DASH-DRAMA, RHETQ, CANONICAL-LINT) with
one-line before/after examples each.

Add checklist item under Core Markers:
  No AI-tell phrasing (hype openers, transitional bloat, promotional
  flourish, hedging, rhetorical-question openers)

Signed-off-by: Eike Waldt <waldt@b1-systems.de>
On-behalf-of: SAP <eike.waldt@sap.com>
Assisted-by: Kilo:claude-opus-4-7
Assisted-by: Kilo:claude-sonnet-4-6
…ed phrasing

Rules: HEDGE (1 occurrence)

Signed-off-by: Eike Waldt <waldt@b1-systems.de>
On-behalf-of: SAP <eike.waldt@sap.com>
Assisted-by: Kilo:claude-opus-4-7
Assisted-by: Kilo:claude-sonnet-4-6
…generated phrasing

Rules: HYPE-OPEN (2 occurrences)

Signed-off-by: Eike Waldt <waldt@b1-systems.de>
On-behalf-of: SAP <eike.waldt@sap.com>
Assisted-by: Kilo:claude-opus-4-7
Assisted-by: Kilo:claude-sonnet-4-6
Rules: CANONICAL-LINT (1 occurrence)

Signed-off-by: Eike Waldt <waldt@b1-systems.de>
On-behalf-of: SAP <eike.waldt@sap.com>
Assisted-by: Kilo:claude-opus-4-7
Assisted-by: Kilo:claude-sonnet-4-6
Rules: TITLE-CASE (1 occurrence)

Signed-off-by: Eike Waldt <waldt@b1-systems.de>
On-behalf-of: SAP <eike.waldt@sap.com>
Assisted-by: Kilo:claude-opus-4-7
Assisted-by: Kilo:claude-sonnet-4-6
…-generated phrasing

Rules: COPULA-DODGE (1 occurrence), NEG-PARALLEL (1 occurrence)

Signed-off-by: Eike Waldt <waldt@b1-systems.de>
On-behalf-of: SAP <eike.waldt@sap.com>
Assisted-by: Kilo:claude-opus-4-7
Assisted-by: Kilo:claude-sonnet-4-6
…ve AI-generated phrasing

Rules: CANONICAL-LINT (1 occurrence)

Signed-off-by: Eike Waldt <waldt@b1-systems.de>
On-behalf-of: SAP <eike.waldt@sap.com>
Assisted-by: Kilo:claude-opus-4-7
Assisted-by: Kilo:claude-sonnet-4-6
@netlify

netlify Bot commented Jul 9, 2026

Copy link
Copy Markdown

Deploy Preview for gardenlinux-docs ready!

Name Link
🔨 Latest commit ae2f830
🔍 Latest deploy log https://app.netlify.com/projects/gardenlinux-docs/deploys/6a4f9ed683175f0008c9cdec
😎 Deploy Preview https://deploy-preview-107--gardenlinux-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@yeoldegrove yeoldegrove merged commit ccf19ba into main Jul 14, 2026
16 of 18 checks passed
@yeoldegrove yeoldegrove self-assigned this Jul 14, 2026
@yeoldegrove yeoldegrove added this to the 2026-07 milestone Jul 14, 2026
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.

1 participant