Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

[documentation-style] Explicitly forbid the em-dash character

Open Beginner friendly
#33 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
Under an hour
Newbie friendliness
88/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Quiet
Domain
documentation

Research direction

Start with .github/instructions/documentation-style.instructions.md line 11 and .github/skills/documentation-style/SKILL.md line 13. Update both rules so the literal em-dash character is forbidden in all uses and instructs writers to rewrite the sentence instead. Done means both files contain the same guidance and no other behavior is changed.

Written by the indexing model from the issue text.

Description

documentation

The current rule bans hyphens/dashes only when used as separators between concepts. Extend it to forbid the literal em-dash character outright.

Current rules:

  • .github/instructions/documentation-style.instructions.md line 11
  • .github/skills/documentation-style/SKILL.md line 13

Acceptance criteria

  • Both files state the em-dash character must not be used at all.
  • Guidance to rewrite the sentence instead.
Dominant language
No language data
Stars
44
Forks
10
Avg merge
6h 49m
Merged PRs (30d)
1

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from microsoft/devsquad-copilot

All issues in microsoft/devsquad-copilot

Similar issues

More Documentation issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.