docs: separate shared style guide from repo-specific config#2304
docs: separate shared style guide from repo-specific config#2304marcel-rbro merged 11 commits intomasterfrom
Conversation
Extract grammar mechanics into a new grammar-rules.md file covering hyphenation, contractions, e.g./i.e., numbers, list punctuation, and brand spelling. Refocus writing-style.md on voice and tone by removing formatting sections that duplicate content-standards.md. Add article usage rules for Apify products, crawler/scraper capitalization, and US vs British English patterns to the shared style guide files. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add grammar-rules.md references to README, instructions, quality checklist, and review skill. Update file descriptions across all config files to reflect the new separation of concerns. Restructure review-docs skill to use subagent delegation for style compliance checks against individual rules files. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
|
Preview for this PR was built for commit |
|
Preview for this PR was built for commit |
…dards in AGENTS.md
|
Preview for this PR was built for commit |
…ty and consistency
|
Preview for this PR was built for commit |
|
Preview for this PR was built for commit |
danpoletaev
force-pushed
the
docs/separate-style-guide-rules
branch
from
e8c11cb to
9626210
Compare
|
Preview for this PR was built for commit |
metalwarrior665
force-pushed
the
docs/separate-style-guide-rules
branch
from
9626210 to
e8c11cb
Compare
|
Preview for this PR was built for commit |
|
Preview for this PR was built for commit |
|
Preview for this PR was built for commit |
TC-MO
left a comment
TC-MO
left a comment
There was a problem hiding this comment.
Just a minor nit otherwise, LGTM
Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>
|
Preview for this PR was built for commit |
|
Preview for this PR was built for commit |
3 participants
Summary
Separate general Apify writing style rules from repository-specific Markdown/Docusaurus conventions to
enable future reuse across other Apify teams.
content-standards.md into writing-style.md
images)
After this PR, general files (
writing-style.md,grammar-rules.md,terminology.md) contain norepo-specific content and can be extracted into a shared repository. Repo-specific files
(
content-standards.md,file-organization.md,quality-standards.md) stay here.