Skip to content

docs: fix style guide violations in platform documentation#2311

Merged
marcel-rbro merged 5 commits intomasterfrom
docs/fix-style-guide-violations-platform
Mar 5, 2026
Merged

docs: fix style guide violations in platform documentation#2311
marcel-rbro merged 5 commits intomasterfrom
docs/fix-style-guide-violations-platform

Conversation

@marcel-rbro
Copy link
Copy Markdown
Contributor

@marcel-rbro marcel-rbro commented Mar 5, 2026

Summary

Fix style guide violations across 65 platform documentation files.

  • Em dashes (—): Replaced with hyphen with spaces ( - )
  • Gerund headings: Converted -ing form headings to imperative forms (e.g. "Running Actors" → "Run Actors")
  • Title case headings: Converted to sentence case
  • Admonitions without titles: Added descriptive 2-3 word titles
  • Terminology capitalization: Fixed incorrect casing (e.g. "actor" → "Actor", "MCP Server" → "MCP server", "Webhook" → "webhook")

Files modified

65 files in sources/platform/ including actors, integrations, storage, proxy, console, collaboration, and schedules documentation.

🤖 Generated with Claude Code


Note

Low Risk
Docs-only wording/formatting updates with no code or behavior changes; risk is limited to minor link/anchor or rendering regressions from heading text changes.

Overview
Applies a broad docs-only style cleanup across ~65 sources/platform/ pages to align with the documentation style guide.

Changes include converting gerund/title-case headings to sentence-case imperative forms, replacing em dashes with spaced hyphens, adding titles to untitled admonitions, and normalizing terminology/capitalization (e.g., Apify Console, MCP server, webhook).

Written by Cursor Bugbot for commit a111eed. Configure here.

Fix em dashes, gerund headings, title case headings, admonitions without
titles, and terminology capitalization across 65 files in sources/platform/.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions github-actions bot added the t-docs Issues owned by technical writing team. label Mar 5, 2026
@apify-service-account
Copy link
Copy Markdown

Preview for this PR was built for commit 3bceb75 and is ready at https://pr-2311.preview.docs.apify.com!

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@marcel-rbro marcel-rbro marked this pull request as ready for review March 5, 2026 09:48
@marcel-rbro marcel-rbro requested a review from TC-MO as a code owner March 5, 2026 09:48
@apify-service-account
Copy link
Copy Markdown

Preview for this PR was built for commit a111eed and is ready at https://pr-2311.preview.docs.apify.com!

These sections are being removed in a separate PR, so reverting
the casing change here avoids merge conflicts.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@apify-service-account
Copy link
Copy Markdown

Preview for this PR was built for commit 301ed25 and is ready at https://pr-2311.preview.docs.apify.com!

Copy link
Copy Markdown
Contributor

@TC-MO TC-MO left a comment

Choose a reason for hiding this comment

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

Apart from:

  • FAQ that we discussed
  • Troubleshooting

LGTM

marcel-rbro and others added 2 commits March 5, 2026 11:03
"Troubleshooting" is a ubiquitous expression and should not be
converted to the imperative form.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@apify-service-account
Copy link
Copy Markdown

Preview for this PR was built for commit 2366bfe and is ready at https://pr-2311.preview.docs.apify.com!

@apify-service-account
Copy link
Copy Markdown

Preview for this PR was built for commit 772a8a1 and is ready at https://pr-2311.preview.docs.apify.com!

@marcel-rbro marcel-rbro merged commit 4237e0a into master Mar 5, 2026
13 checks passed
@marcel-rbro marcel-rbro deleted the docs/fix-style-guide-violations-platform branch March 5, 2026 11:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

t-docs Issues owned by technical writing team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants