Skip to content

Latest commit

 

History

History
128 lines (96 loc) · 4.48 KB

File metadata and controls

128 lines (96 loc) · 4.48 KB

Contributing to Stringy

Stringy weaves together the best of industry-standard open-source practiceswith a touch of friendliness ❤️, making your contributions meaningful and easy on the brain.

🚀 Start Here:


🛤️ Contribution Stations

In the Stringy codebase, you'll find several "Contribution Stations". These are specially marked sections where we encourage contributions, particularly from those who are new to open source or to the project.

What is a Contribution Station?

A Contribution Station is a segment of code, marked with a special comment, where we invite you to contribute functions or enhancements. Each station provides:

  • A clear description of what's needed.
  • An example input and the expected output.
  • A placeholder where you can write your code.

### Example:
// 🔄 Contribution Station - Create a string Reverse function
function stringReverse(string) {
  // Input: 'Stringy'
  // Expected Output: 'Enhanced ygnirtS'
  // Write your code here and export it.
}

🧵 How to Contribute at a Station


Step 1: 👀 Find the Contribution Station suitable for you from Good First Issue


→ Begin by looking for issues tagged as 'good first issue'. These are great for getting warmed up!



Step 2: 🌿 Create a Branch


→ On the issue page, start by creating a branch. This keeps the main codebase safe while you make your changes.



Step 3: 🏡 Clone the Repo


→ Clone the Stringy repository to your local machine and switch to your new branch to begin coding.


→ Your new branch will look like this on GitHub:



Step 4: 💾 Commit Your Changes


→ Time to save your changes with a good commit message. Don't worry, it's just your branch.

Step 5: ⬆️ Push Your Changes

→ Push your commits to your GitHub branch.

Step 6: 🔄 Back to GitHub Repo


→ Upon pushing your changes, you'll see an update in your repository with an option to create a Pull Request.



Step 7: ➕ Open a Pull Request


→ Now, let the world see your work. Click on the green button or follow the next steps to open a Pull Request.



→ Detail your changes and submit your PR:



Step 8: 📬 PR Opened

→ Your PR is now waiting for review. Nice work!



Step 9: 🎉 Merge and Celebrate


→ After your PR is reviewed and approved, it'll be merged. Congratulations, you're a Stringy contributor!

Now, take a moment like Pablo to enjoy your accomplishment. You've taken a big step in your open-source journey with Stringy. Keep it up! 🌟