README Polish
Improve an existing README's clarity and structure while preserving its intent.
Steps
- Read the current README in full before changing anything.
- Check that it answers the questions a new reader asks, in order:
- What is this project and who is it for?
- How do I install it?
- How do I use it (a minimal, copy-pasteable example)?
- How do I configure it?
- How do I contribute / where do I get help?
- Restructure and tighten the prose. Do not invent features, commands, or claims that aren't supported by the project.
Suggested structure
# Project Name
One-line description.
## Installation
## Usage
## Configuration
## Contributing
## License
Guidelines
- Preserve technical accuracy above all — when unsure whether a command or claim is correct, flag it for the user instead of guessing.
- Prefer a short, working example over a long prose explanation.
- Keep headings shallow and scannable; use code fences for all commands.
- Don't pad. Every section should earn its place.