solid / solid/solidproject.org
Guideline: replace weasel words by concrete, clear, and specific texts
Nobody has claimed this yet.
- Dominant language
- HTML
- Stars
- 183
- Forks
- 152
- PR merge metrics
- No merged PRs in 30d
Description
Remove weasel words, as well as buzzwords, unsubstantiated, vague claims... from site content eg:
"This is a massive improvement to your privacy."
How massive? Compared to what? How was that measured? Who measured it? What's covered?
"The last login you'll ever need"
Perhaps we can tone down bold statements? Which decentralisation project or identifier/authn/z system doesn't make similar claims nowadays?
...
I don't have exact suggestions on how to improve the text right now. Favouring modest and friendly/approachable tones. It shouldn't feel like my life is incomplete without Solid or I must buy this new thing so I can reach my potential and be a good webizen.
Contributor guide
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.
Research direction
Start by reviewing the issue's examples and auditing the site content for weasel words, buzzwords, vague claims, and unsupported statements. The issue names no files or tests, so locate the relevant site copy first. Done means the affected text uses a modest, friendly, concrete, and specific tone without exaggerated claims.
Written by the indexing model from the issue text.
Assessment
- Domain
- content
- Issue type
- Documentation
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 25/100