carpentries / carpentries/understood-recommendations
Adopt “plain language” or link out to more complex terms
Open
general
- Dominant language
- No language data
- Stars
- 1
- Forks
- 0
- PR merge metrics
- No merged PRs in 30d
Description
Complex communications make communication less effective. Plain text helps with ESL and those who may struggle with language.
Contributor guide
Research direction
Start by reviewing the issue body and the repository's existing communications to identify what content is in scope. The issue does not name files, entry points, or tests, so the work is not complete until the scope and concrete acceptance criteria for adopting plain language or linking complex terms are defined.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 25/100