Skip to content

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

Open
yeoldegrove wants to merge 11 commits into
mainfrom
docs/humanize
Open

docs: define and remove "AI-generated phrasing"#107
yeoldegrove wants to merge 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.

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