Thanks for considering a contribution! PLAIN is an open source project and gets better with every improvement, whether it's fixing a typo, suggesting a new section, or sharing a real-world example.
This guide will help you get started.
There are several ways to help PLAIN grow. Pick what suits you best.
- Fix typos and improve clarity: Spot a typo or awkward sentence? Submit a quick fix. Small improvements add up over time.
- Improve the PLAIN template: If you have ideas to make
PLAIN.mdclearer or more useful, suggest edits or submit a PR. - Share real-world examples: If you've created a
{project-name}-plain.mdfor your own project, submit it with a live demo or design link to inspire others. - Suggest structural changes: If you think a section should be added, renamed, or removed, open an issue and let's discuss.
Contributing is simple. Fork the repo, create a branch, make your changes, and open a pull request.
- Fork the repository and clone it locally.
- Create a branch with a clear name like
fix/readme-typosoradd/plain-taskly. - Make your changes and follow existing formatting conventions.
- Open a pull request with a short description of what you changed and why.
Keep these in mind when contributing:
- Write clearly: Make your content easy to understand for both humans and AI. Avoid vague or overly abstract language.
- Stay consistent: Follow the tone, format, and naming conventions used in existing files. For example submissions, use
{project-name}-plain.mdwith lowercase letters and hyphens. - Use AI to polish your work: This is an AI-focused project. Feel free to use Claude, ChatGPT, or other tools to refine your contributions.
- Discuss big changes first: For structural or conceptual changes, open an issue before submitting a PR.
We want PLAIN to be a welcoming space for everyone. Be respectful, constructive, and kind in all interactions. Harassment, discrimination, or toxic behavior of any kind won't be tolerated.
For full details, see CODE_OF_CONDUCT.md.
Your contribution, no matter how small, helps make PLAIN better for everyone. Thanks for being part of this.
Happy contributing! 🚀