Skip to content

Latest commit

ย 

History

History
153 lines (89 loc) ยท 7.55 KB

README.en-pirate.md

File metadata and controls

153 lines (89 loc) ยท 7.55 KB

Open Source Love License: MIT Open Source Helpers

First Contributions

'tis hard. 'tis always hard th' first time ye do somethin'. Especially when ye be collaboratin', makin' mistakes ain't a comfortable thin'. We wanted t' simplify th' way new open-source contributors learn & contribute fer th' first time.

Readin' tales & watchin' tutorials can help, but wha''s better than actually doin' th' stuff in a practice environment? This project aims at providin' guidance & simplifyin' th' way beginners make thar first contribution. If ye be lookin' t' make yer first contribution, follow th' steps below.

If ye're nah comfortable wit' command line, here be tutorials usin' GUI tools.

Read this in other languages.

๏ธ๐Ÿ‡ฌ๐Ÿ‡ง ๐Ÿ‡ฎ๐Ÿ‡ณ ๐Ÿ‡ฒ๐Ÿ‡ฒ ๐Ÿ‡ฎ๐Ÿ‡ฉ ๐Ÿ‡ซ๐Ÿ‡ท ๐Ÿ‡ช๐Ÿ‡ธ ๐Ÿ‡ณ๐Ÿ‡ฑ ๐Ÿ‡ท๐Ÿ‡บ ๐Ÿ‡ฏ๐Ÿ‡ต ๐Ÿ‡ป๐Ÿ‡ณ ๐Ÿ‡ต๐Ÿ‡ฑ ๐Ÿ‡ฎ๐Ÿ‡ท ๐Ÿ‡ฎ๐Ÿ‡ท ๐Ÿ‡ฐ๐Ÿ‡ท ๐Ÿ‡ฐ๐Ÿ‡ต ๐Ÿ‡ฉ๐Ÿ‡ช ๐Ÿ‡จ๐Ÿ‡ณ ๐Ÿ‡น๐Ÿ‡ผ ๐Ÿ‡ฌ๐Ÿ‡ท ๐Ÿ‡บ๐Ÿ‡ฆ ๐Ÿ‡ง๐Ÿ‡ท ๐Ÿ‡ต๐Ÿ‡น ๐Ÿ‡ฎ๐Ÿ‡น ๐Ÿ‡น๐Ÿ‡ญ ๐Ÿด๓ ฅ๓ ณ๓ ง๓ ก๓ ฟ ๐Ÿ‡ต๐Ÿ‡ฐ ๐Ÿ‡ง๐Ÿ‡ฉ ๐Ÿ‡ฒ๐Ÿ‡ฉ ๐Ÿ‡ท๐Ÿ‡ด ๐Ÿ‡น๐Ÿ‡ท ๐Ÿ‡ธ๐Ÿ‡ช ๐Ÿ‡ฎ๐Ÿ‡ฑ

fork this repository

If ye don't 'ave git on yer machine, install it.

Fork this repository

Fork this repo by skewerin' on th' fork button on th' top o' this page. This will create a copy o' this repository in yer account.

Clone the repository

clone this repository

Now clone this repo t' yer machine. Go t' yer GitHub account, skewer on th' clone button 'n then skewer th' copy to clipboard icon.

Open a terminal 'n run th' followin' git command:

git clone "url ye jus' copied"

where "url ye jus' copied" (without th' quote marks) be th' url t' this repository (yer fork o' this project). See th' previous steps t' obtain th' url.

copy URL to clipboard

Fer example:

git clone https://github.com/this-be-ye/first-contributions.git

where this-be-ye be yer GitHub username. Here ye're copyin' th' contents o' th' first-contributions repository in GitHub t' yer 'puter.

Create a branch

Change t' th' repository directory on yer 'puter (if ye be nah already thar):

cd first-contributions

Now create a branch usin' th' git checkout command:

git checkout -b <add-your-new-branch-name>

Fer example:

git checkout -b add-luke-oliff

(Th' name o' th' branch does nah needs t' 'ave th' word add in it, but 'tis a reasonable thin' t' include 'cause th' purpose o' this branch be t' add yer name t' a list.)

Make necessary changes 'n commit those changes

Now open Contributors.md file in a text editor, add yer name t' it. Don't add it at th' beginnin' or end o' th' file. Put it anywhere in between. Now, save th' file.

git status

If ye go t' th' project directory 'n execute th' command git status, ye'll see thar are changes.

Add those changes t' th' branch ye jus' created usin' th' git add command:

git add Contributors.md

Now commit those changes usin' th' git commit command:

git commit -m "Add <yer-name> to Contributors list"

replacing <yer-name> with your name.

Push changes t' GitHub

Push yer changes usin' th' command git push:

git push origin <add-yer-branch-name>

replacin' <add-yer-branch-name> wit' th' name o' th' branch ye created earlier.

Submit yer changes fer review

If ye go t' yer repository on GitHub, ye'll see a Compare & pull request button. Click on that button.

create a pull request

Now submit th' pull request.

submit pull request

Soon I'll be mergin' all yer changes into th' master branch o' this project. Ye will get a notification email once th' changes 'ave been merged.

Delete th' branch aft pull request has been merged

Ye can safely scuttle yer branch <add-yer-branch-name> aft th' pull request has been merged. Ye'll see a button t' scuttle th' branch:

delete branch after PR is merged

If th' Pull Request was closed without bein' merged, GitHub will warn ye about scuttlin' unmerged commits 'n th' button will look like this:

delete branch after PR is not merged

Where t' go from here?

Well done! Ye jus' completed th' standard fork -> clone -> edit -> PR workflow that ye'll encounter often as a contributor!

Celebrate yer contribution 'n share it wit' yer hearties 'n followers by goin' t' web app.

Ye could join our slack crew in case ye needs any help or 'ave any riddles. Join our slack crew.

Now let's get ye started wit' contributin' t' other projects. We've compiled a list o' projects wit' easy issues ye can get started on. Check out th' list o' projects in web app.

Tutorials Usin' Other Tools

GitHub Desktop Visual Studio 2017 GitKraken
GitHub Desktop Visual Studio 2017 GitKraken

Self-Promotion

If ye liked this project, star it on GitHub. If ye're feelin' especially charitable, follow Roshan on Twitter and GitHub.

https://app.saasgrids.com