Contributing to PrepVerse
PrepVerse is open source and improves through community contributions. All skill levels are welcome.
Ways to help
| Contribution | Effort | How |
|---|---|---|
| Report a mistake or broken link | 5 min | Open a GitHub issue |
| Fix a typo or unclear sentence | 10 min | Edit the page on GitHub (use the "Edit this page" link) |
| Add a code example or exercise | 1 hour | Pull request |
| Write a new lesson | A few hours | Pull request following the style below |
| Review a pull request | 30 min | Comment on open pull requests |
Pull request workflow
# fork the repository on GitHub first, then:
git clone https://github.com/<your-username>/<your-fork>.git
cd <your-fork>/documentation
git checkout -b my-change
npm install
npm start # live preview at http://localhost:3000
# make your changes, then
npm run lint
npm run build # must pass: it also checks broken links
git commit -am "Describe your change"
git push origin my-change
Then open a pull request and describe what changed and why.
Lesson style guide
- One topic per page; start with a one-sentence definition.
- Prefer runnable examples with short comments.
- Use tables for comparisons and complexity summaries.
- Add
titleanddescriptionin the front matter; keep the description under 160 characters. - Use admonitions (
:::tip,:::caution,:::note) sparingly. - Link related lessons instead of repeating content.
NOTE
Please do not include copyrighted material or content you do not have the right to share.
Code of conduct
Be respectful and constructive. See the Code of Conduct.
Loading Comments...