Welcome Note First of all, We are happy to have you here as a Contributor. You contribution and collboration really matters. Share your ideas with other and also get those green-squares on your GitHub profile.
In order to contribute, your first step is to fork this project. Creating a fork will make a copy of this project to your GitHub account.
Just go to the main page of this project and click the fork button at the top-right section.
Now you need to clone the forked repository to your system and then all the code/docs changes that you'll make, will be in the cloned repository only.
- Open your terminal (Command Prompt, Git Bash, Powershell)
- Go to the directory where you want to clone your project. For example, Let's say you have a folder named as
opensourceat the Desktop where you want to clone your project then your command prompt path should look like this.
For Windows:
C:\user\Desktop\opensource>For Mac (Terminal):
username's-Mac:~desktop/opensource$then write the command given below:
git clone https://github.com/<github-username>/eccentrictouch.gitthen cd to the project by writing
cd getButtons.ioCongratulations! All the setup related things are done now you can go further :)
If you are Raising an Issue
Raising issues really helps this project to grow more and have great usability. There are some type of issues which are listed in the screenshot below.
All the issues have pre-designed content template. If you have selected Bug Report issue type then precisely explain your report or the issue you have faced. Try adding screenshots (if possible) for more clarification.
If you have selected Feature Request then explain the feature in description like how it will be implemented, why it is required and if you want to work on that issue then write an assignment request also that you want to work on it. May be as a comment or in the issue itself and we'll get back to your request and start the discussion.
If you want to implement a new design or you want make changes with some design, you can create an issue by selecting Design Implementation. Make sure you attach some Screenshots of your design and explain it so that others can also contribute to it.
Other than these, you have you have community joining related issue also such as Community Joining Request and Project Maintainer Request
You can raise an issue in order to join the community on GitHub and Discord. We could have directly shared the discord server link with you but it has expiry issues. But whenever you'll raise the joining issue, our team will get back to you. Also, you can be an active member at The DesignSystems Community on GitHub and have a logo under your profile - The mark of working/contributing at The DesignSystems projects.
You can raise an issue also to become a Project Maintainer at The DesignSystems Community. Just raise your request and we'll get back to you and have a discussion. Easy right!?
If you are solving an issue
That's great that you want to work on an issue. All the issue are listed at the issue tab-section with proper titles, labels and assignments. Just open the issue you want to work on and request an assignment in the comments section.
Feel comfortable to ask your doubts related to that issue. Ask everything, whatever is in your mind, we are there to help you out.
If you are doing code changes then make sure that your branch is v2.0
To switch from master branch to v2.0, you need to write.
git checkout DevelopmentTime for the real-work, Open your code editor and start working on that issue. Thoroughly go to the file structure of the project. When you are done with the changes, it's time to create a Pull Request.
Go to your terminal again, and write the commands mentioned below.
1. First you need to add your changes to the Staging area.
git add <FILENAME_WHERE_YOUR_CODE_CHANGES_ARE>If you want to add everything at the time then just write
git add .But for a good-developer practice always add files according to the types of changes made.
2. Commit your code changes with a short(informative) message
git commit -m "<A SHORT MESSAGE/LINE EXPLAINING YOUR CODE CHANGES> <ISSUE_TAG_IF_POSSIBLE>"for an example, you have changed the CSS Properties for the Header and the issue-tag was #123 then the proper way to commit your code changes would be.
git commit -m "CSS Properties for Header changed (#123)"And your changes are committed!
3. Push your Code Changes
git push -u origin DevelopmentMake sure that you have done your code changes on the Development branch and push on the same branch - The Development branch.
Voila! Your code changes are pushed to your forked repository. Time to create a PR!! ⭐
4. Go to your forked Repository
When you will go to your forked repository, You will see a message/notification like this.
Click of the Green Coloured Compare & Pull Request Button
Now after clicking the button you need to write a short but informative message in order to support your changes. For example, The one given below
Also, Don't forget to request a review from our project maintainers. Select to at least 1-2 project maintainers to review your Pull Request. Just like this.
All set! Submit your PR. Click the Create Pull Request button.
Then wait for the checks, and the discuss the stuff if required with our project maintainers and after all the checks we'll merge your Pull Request. 😃