What and why
Our documentation style avoids em dashes and en dashes in favor of commas, colons, parentheses, or separate sentences. Several markdown files on main still contain them. This is a pure wording cleanup, ideal as a first documentation contribution.
Pointers
Files currently containing em dashes:
CONTRIBUTING.md
SECURITY.md
docs/guides/07-contribute-to-official.md
docs/guides/09-create-feature-group.md
docs/guides/compute-framework-patterns/06-merge-engine.md
docs/guides/compute-framework-patterns/10-data-type-extraction.md
docs/guides/data-operation-patterns/known-divergences.md
docs/guides/feature-group-patterns/19-domain.md
docs/guides/feature-group-patterns/23-streaming.md
docs/guides/feature-group-patterns/24-realtime.md
Steps
- Search these files for
— and –.
- Rewrite each sentence with a comma, colon, parentheses, or a period, keeping the meaning intact. Do not change code blocks' behavior.
- Run
python scripts/lint_docs.py to make sure the docs linter still passes.
Acceptance criteria
- No em or en dashes remain in the listed files.
- Sentences still read naturally; no content meaning changed.
python scripts/lint_docs.py exits 0.
Notes
This project uses semantic versioning driven by Conventional Commits, so the PR title matters: use docs: replace em dashes with plain punctuation.
New to the project? This issue is a good entry point, we are happy to help in the comments.
If you like the project, a star on the repo helps others find it. ⭐
What and why
Our documentation style avoids em dashes and en dashes in favor of commas, colons, parentheses, or separate sentences. Several markdown files on main still contain them. This is a pure wording cleanup, ideal as a first documentation contribution.
Pointers
Files currently containing em dashes:
CONTRIBUTING.mdSECURITY.mddocs/guides/07-contribute-to-official.mddocs/guides/09-create-feature-group.mddocs/guides/compute-framework-patterns/06-merge-engine.mddocs/guides/compute-framework-patterns/10-data-type-extraction.mddocs/guides/data-operation-patterns/known-divergences.mddocs/guides/feature-group-patterns/19-domain.mddocs/guides/feature-group-patterns/23-streaming.mddocs/guides/feature-group-patterns/24-realtime.mdSteps
—and–.python scripts/lint_docs.pyto make sure the docs linter still passes.Acceptance criteria
python scripts/lint_docs.pyexits 0.Notes
This project uses semantic versioning driven by Conventional Commits, so the PR title matters: use
docs: replace em dashes with plain punctuation.New to the project? This issue is a good entry point, we are happy to help in the comments.
If you like the project, a star on the repo helps others find it. ⭐