Skip to main content

Contributing to PrepVerse

PrepVerse is open source and improves through community contributions. All skill levels are welcome.

Ways to help​

ContributionEffortHow
Report a mistake or broken link5 minOpen a GitHub issue
Fix a typo or unclear sentence10 minEdit the page on GitHub (use the "Edit this page" link)
Add a code example or exercise1 hourPull request
Write a new lessonA few hoursPull request following the style below
Review a pull request30 minComment 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 title and description in 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.