Skip to content

[Need support]: Replace em dashes with plain punctuation in docs #42

Description

@TKaltofen

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
  • README.md
  • SECURITY.md
  • THIRD_PARTY_NOTICES.md
  • open_kgo/feature_groups/kg/README.md

Steps

  1. Search these files for and .
  2. Rewrite each sentence with a comma, colon, parentheses, or a period, keeping the meaning intact. Do not change code blocks or license texts quoted verbatim.
  3. Run tox to confirm nothing else broke.

Acceptance criteria

  • No em or en dashes remain in the listed files (outside verbatim license quotations, if any).
  • Sentences still read naturally; no content meaning changed.

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. ⭐

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationgood first issueGood for newcomershelp wantedExtra attention is needed

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions