[documentation-style] Prefer plain wording accessible to non-native speakers
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 72/100
- Issue type
- Documentation
- Clarity
- Mostly clear
- Activity status
- Quiet
- Domain
- documentation
Research direction
No file or entry point is named. Locate the repository’s existing documentation style guidance and review how wording recommendations are organized. Add guidance favoring plain, widely understood vocabulary, including an example such as “locus,” and verify that the acceptance criteria are covered.
Written by the indexing model from the issue text.
Description
Prefer simple, widely understood wording over sophisticated or academic terms so a global audience including non-native English speakers can follow easily.
Example to avoid: "locus" (academic Latin).
Acceptance criteria
- Documentation style guidance recommends plain vocabulary and gives examples of terms to avoid.
- Dominant language
- No language data
- Stars
- 44
- Forks
- 10
- PR merge metrics
- No merged PRs in 30d
Getting set up
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from microsoft/devsquad-copilot
-
documentation
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
-
documentation
Difficulty 1/5 Under an hour Newbie friendliness 88/100
-
enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
enhancement
Difficulty 5/5 Over a week Newbie friendliness 35/100
-
question
Difficulty 5/5 Over a week Newbie friendliness 25/100
All issues in microsoft/devsquad-copilot
Similar issues
-
documentation
Difficulty 1/5 1-3 hours Newbie friendliness 88/100
Maintainers usually reply within 1 day
-
sync-en
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
Maintainers usually reply within 2 days
-
bug docs
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
Maintainers usually reply within 1 day
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
Maintainers usually reply within 1 day