diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 47ae65bbea3..26a27b4a00f 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -29,4 +29,5 @@ We have some rules for translation. If you make the first translation for your l - [x] Fixed grammar for contribution Guide - [ ] Add more example and more guide + Thanks! :heart: diff --git a/Contributors.md b/Contributors.md index 4881c7ac794..ef6a3d754f9 100644 --- a/Contributors.md +++ b/Contributors.md @@ -1,8 +1,22 @@ +- [Brett Davis](https://github.com/saintbernie) +- [Shadab Khan](https://github.com/shadabk96) +- [Shubham Chauhan](https://github.com/ShubhamSinghChauhan) +- [Gaurav Rai](https://github.com/ThinkHattke) +- [Mintoo Kumar](https://github.com/mintoo511) +- [Rubén Ortiz](https://github.com/rubenortiz) +- [Petrov Dumitru](https://github.com/dp97) +- [Saideep Dicholkar](https://github.com/saideepd) +- [Oliver Miller](https://github.com/Oliver-H-Miller) +- [Gabriel Cueto](https://github.com/TheMushrr00m) +- [Lewis Shaw](https://github.com/iRuisu) +- [Bao Tran](https://github.com/cyborg103) - [Jithu R Jacob 🤓](https://github.com/jithurjacob) +- [Ashutosh Singh](https://github.com/ashubly25) - [gipsi](https://github.com/gipsi) - [girlzap](https://github.com/girlzap) - [DevMaterial](https://github.com/DevMaterial) - [drac00l](https://github.com/drac00l) +- [Jonathan Rinciari](https://github.com/jonathanRinciari) - [Neha Upadhyay] - [jaro36](https://github.com/jaro36/) - [Björn Hjorth](https://github.com/Kaffesumpen) @@ -48,6 +62,7 @@ - [Eduard Barata](https://github.com/bar-alex) - [Richard Placide](https://github.com/richardplacide) - [Jake Frn](https://github.com/jakefrn) +- [Napat](https://github.com/napatwongchr) - [Eric Audran](https://github.com/Nevosis) - [Silvino Vieiew](https://github.com/silvinovieira) - [Michael Isprihanto](https://github.com/michaelisprihanto) @@ -132,6 +147,7 @@ - [Adarsh Lilha](https://github.com/adarshlilha) - [Meghana](https://github.com/meMegna) - [mrluissan](https://github.com/mrluissan) +- [Jibin Mathews](https://github.com/jazzyarchitects) - [ramseyjacob](https://github.com/ramseyjacob) - [Nithin K Vijayan](https://github.com/nithin-vijayan) - [Karan Deep Batra](https://github.com/krnbatra) @@ -200,6 +216,7 @@ - [Vakas Zia](https://github.com/MVakas) - [xribene](https://github.com/xribene) - [ArcticSniper] +- [Wei-Chien Hsu](https://github.com/WeiChienHsu) - [Angga Indriya Pamungkas](https://github.com/anggaip) - [Joaqu�n Pignol](https://github.com/joespi) - [Srijan Manandhar](https://github.com/srijanss) @@ -726,6 +743,7 @@ - [subhamtandon](https://github.com/subhamtandon) - [Vanessa Osuka](https://github.com/Ijebusoma) - [Akash Saravanan](https://github.com/akashsara) +- [Spencer Burleigh](https://github.com/leaous) - [Shaun O'Connor](https://github.com/shaunoc09) - [Marek Dano](https://github.com/marekdano) - [Marcos Gómez](https://github.com/margobra8) @@ -764,6 +782,7 @@ - [Karthik Murugesan](https://github.com/karthikmuru) - [TheHungryBu](https://github.com/TheHungryBu) - [Valeriia Kolesnyk](https://github.com/xvaleriex) +- [José Carlos Peñuelas Armenta](https://github.com/Jocapear) - [Rakesh Bal](https://github.com/rakeshbal99) - [Reynaldo Wijaya Hendry](https://github.com/rwhendry) - [Josef](https://github.com/josef9283) @@ -792,3 +811,129 @@ - [James Lave](https://github.com/jameslave) - [Rovaron](https://github.com/Rovaron) - [Augusto Queiroz](https://github.com/AugustoQueiroz) +- [LRThesier](https://github.com/lrthesier) +- [Brianna Florio](https://github.com/Bflorio14) +- [Joe Wilson](https://github.com/jaw0608) +- [Paul Chabot](https://github.com/paulch4bot) +- [Tim Guenthner](https://github.com/aerotog) +- [Jhonatan Casale](https://github.com/jhonatancasale) +- [Kik Tachanok](https://github.com/tachanokkik) +- [Anastasios (Tasos) Beis](https://github.com/abeis) +- [Syk Houdeib](https://github.com/Syknapse) +- [avsingh999](https://github.com/avsingh999) +- [dmnkhhn](https://github.com/dmnkhhn) +- [Ashik Paul](https://github.com/Ashikpaul) +- [CJ Haviland](https://github.com/cjhaviland) +- [Shuyue Wang](http://github.com/k1631111) +- [Zimi14](https://github.com/Zimi14) +- [samanthalgibson](https://github.com/samanthalgibson) +- [Atlas34](https://github.com/Atlas34) +- [Ivan Shen](https://github.com/ivanshen) +- [Jonathan Arredondo](https://github.com/angelyonas) +- [handrezescobar94](https://github.com/handrezescobar94) +- [Ariel Blasi](https://github.com/LiteSoul) +- [Faisal Hassan](https://faisalhassanx.bitbucket.io) +- [daniel-enriquez](https://github.com/daniel-enriquez) +- [Luke Taylor](https://github.com/Luke-Taylor) +- [Jim Plourde](https://github.com/giant995/first-contributions) +- [Shashwat](https://github.com/shpulak) +- [h4rdw0rk](https://github.com/h4rdw0rk/first-contributions) +- [James Francis](https://github.com/greengory) +- [Jimmy Xiao](https://github.com/Fatmylin) +- [Danny Lai](https://github.com/tocalai) +- [Tu Szu Chi](https://github.com/Tu-Szu-Chi) +- [Mark John C. Moreno](https://github.com/phakk) +- [Jianhao Tan](https://github.com/jaanhio) +- [Prajwal Patil](https://github.com/prajwalkpatil) +- [Alex Hsu](https://github.com/Juchuhsu) +- [avcoder](https://github.com/avcoder) +- [Gowtham R](https://github.com/gowtham1997) +- [Uğur Atmaca](https://github.com/uguratmaca) +- [Josix](https://github.com/wilson8507) +- [Dave Gray](https://github.com/gitdagray) +- [Matthew Dray](https://github.com/17robots) +- [Berkay Ersengun](https://github.com/berkayersengun) +- [Guy Livni](https://github.com/GuyLivni) +- [Gilad Bar](https://github.com/GomuGilad6) +- [Daniel Benton](https://github.com/dbenton2) +- [Cesar Omar](https://github.com/wasa4587) +- [Huntley Reep](https://github.com/huntleyreep) +- [dtk](https://github.com/dtk0528) +- [Ocean](https://github.com/ocean0212) +- [Francis](https://github.com/borbefg) +- [WanWan](https://github.com/lf2com) +- [mariannems](https://github.com/mariannems) +- [Emina Zolota](https://github.com/eminazolota) +- [Ana Perez](https://github.com/anacperez) +- [Arjun Rajpal](https://github.com/arjunrajpal) +- [Aman Jain](https://github.com/amanjain97) +- [David Carew](https://github.com/carewdavid) +- [Burste](https://github.com/Burste) +- [Mikaeri Ohana](https://github.com/miohana) +- [bl-rd](https://github.com/bl-rd) +- [Henrik Jönsson](https://github.com/heggrik) +- [Adithya J](https://github.com/adithya321) +- [Hardik Surana](https://github.com/hardiksurana) +- [Carlos Lima](https://github.com/kakamg0) +- [Trevor Roest](https://github.com/twroest) +- [Sukeer](https://github.com/Sukeer) +- [Rohit Mathew](https://github.com/rohitjmathew/) +- [Michele Armellini](https://github.com/armaDio) +- [syamkumar](https://github.com/syam3526/) +- [awesomejerry](https://github.com/awesomejerry) +- [Nathan Mkaya](https://github.com/nathanmkaya/) +- [Rahat](https://github.com/MAHRahat) +- [Justin Abbott](https://github.com/justinabbott) +- [Akkshay Lawrence](https://github.com/akkshaylawrence) +- [cek-cek](https://github.com/cek-cek) +- [Renan Vichetti](https://github.com/rvconessa/) +- [GaganDeep Singh](https://github.com/SGagan) +- [MikeWLloyd](https://github.com/MikeWLloyd) +- [Thespawnexe](https://github.com/Thespawnexe) +- [Andrew Niekamp](https://github.com/andrewniekamp) +- [Aayush Babbar](https://github.com/mooonshot) +- [Xinnan Li](https://github.com/xn0611) +- [javmonisu](https://github.com/javmonisu) +- [Dulantha_teshan](https://github.com/DTeshan) +- [Hussain Mustafa](https://github.com/hussainbadri21) +- [Dilan Nilaksha](https://github.com/jpdilan) gd one dudes :) +- [Sangeetha Sasikumar](https://github.com/Sangeetha-007) +- [Ple](https://github.com/plemomay) +- [Shreyansh Dwivedi](https://github.com/shreyanshdwivedi) +- [Akani](https://github.com/akanijade) +- [Passok11](https://github.com/Passok11) +- [Aprisyta](https://github.com/Aprisyta) +- [Aowongster](https://github.com/aowongster) +- [Wildan Mubarok](https://github.com/willnode) +- [hosjiu](https://github.com/hosjiu1702) +- [ironsketch](https://github.com/ironsketch) +- [cacaorick](https://github.com/cacaorick) +- [namanpreetsingh](https://github.com/namanpreetsingh) +- [Aditya Nugraha](https://github.com/aanugraha) +- [ekas](https://github.com/ekas) +- [Ahmad Javed](https://github.com/ahmadjaved97) +- [BinhPhamKMA](https://github.com/BinhPhamKMA) +- [TheZenti](https://github.com/TheZenti) +- [Matheus Lucena](https://github.com/matehuslucena) +- [Galleria](https://github.com/Galleria) +- [Kirill Motkov](https://github.com/sosiska) +- [AJ Berman](https://github.com/AlexanderAJBerman) +- [masta-bhawk](https://github.com/masta-bhawk) +- [Vishal Raj Shukla](https://github.com/vrs-git) +- [emmaodia](https://github.com/emmaodia) +- [Manuel Romero](https://github.com/Manu8083) +- [ninjandroid](https://github.com/ninjandroid) +- [allykates](https://github.com/allykates) +- [Roy Sung](https://github.com/roysung) +- [Meghna Ayyar][https://github.com/leomi7] +- [MuhFaridZia](https://github.com/mfaridzia) +- [Akshay Ramesh](https://github.com/AkshayRameshAppDEV) +- [Pavillin](https://github.com/Pavillin) +- [Randall Whitlock](https://github.com/randallwhitlock) +- [charlesmonson](https://github.com/charlesmonson) +- [imyrfield](https://github.com/imyrfield) +- [melisaim](https://github.com/MelisaIm) +- [Dario Gabriel](https://github.com/dariogabriel113) +- [BrumGB](https://github.com/brumgb) +- [lthlong](https://github.com/lthlong) +- [decantr](https://github.com/decantr) diff --git a/LANGUAGES.md b/LANGUAGES.md index e1b49776fa4..084a28078be 100644 --- a/LANGUAGES.md +++ b/LANGUAGES.md @@ -24,5 +24,6 @@ | 🇹🇭 Thailand | [ภาษาไทย](translations/README.th.md) | | 🏴󠁥󠁳󠁧󠁡󠁿 Galicia | [Galician](translations/README.gl.md) | | 🇵🇰 Pakistan | [Urdu](translations/README.ur.md) | - +| :bangladesh: Bangladesh | [Bangla](translations/README.bn.md) | +| :moldova: Moldova, :romania: Romania | [Romanian](translations/README.ro.md)| diff --git a/README.md b/README.md index 990beb4a98e..332c69a6ee8 100644 --- a/README.md +++ b/README.md @@ -92,27 +92,27 @@ Now submit the pull request. Soon I'll be merging all your changes into the master branch of this project. You will get a notification email once the changes have been merged. +## Where to go from here? + +Celebrate your contribution and share it with your friends and followers by going to [web app](https://roshanjossey.github.io/first-contributions/#social-share). + +You could join our slack team in case you need any help or have any questions. [Join slack team](https://firstcontributions.herokuapp.com). + +Now let's get you started with contributing to other projects. We've compiled a list of projects with easy issues you can get started on. Check out [the list of projects in web app](https://roshanjossey.github.io/first-contributions/#project-list). + ### [ Additional material ](additional-material/additional-material.md) -## Tutorials Using Other Tools +## Tutorials Using Other Tools |GitHub Desktop|Visual Studio 2017|GitKraken| |---|---|---| |[GitHub Desktop](github-desktop-tutorial.md)|[Visual Studio 2017](github-windows-vs2017-tutorial.md)|[GitKraken](gitkraken-tutorial.md)| -## Where to go from here? - -You could also join our slack team in case you need any help or have any questions. [Join slack team](https://firstcontributions.herokuapp.com) +## Self-Promotion -Here's some beginner level issues in popular repos that you can solve. Go ahead and go to those repos to learn more +If you liked this project, star it on [GitHub](https://github.com/Roshanjossey/first-contributions). +If you're feeling especially charitable, follow [Roshan](https://roshanjossey.github.io/) on +[Twitter](https://twitter.com/sudo__bangbang) and +[GitHub](https://github.com/roshanjossey). -|[![exercism](https://avatars2.githubusercontent.com/u/5624255?v=3&s=100)](https://github.com/exercism/exercism.io/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+patch%22)|[![fun-retro](https://avatars3.githubusercontent.com/u/15913975?v=3&s=100)](https://github.com/funretro/distributed/issues?q=is%3Aopen+is%3Aissue+label%3A%22beginner+friendly%22)|[](https://github.com/facebook/react/issues?q=is%3Aissue+is%3Aopen+label%3A%22Difficulty%3A+beginner%22)|[![habitat](https://avatars1.githubusercontent.com/u/18171698?v=3&s=100)](https://github.com/habitat-sh/habitat/issues?q=is%3Aopen+is%3Aissue+label%3AE-Easy)|[![scikit-learn](https://avatars0.githubusercontent.com/u/365630?v=3&s=100)](https://github.com/scikit-learn/scikit-learn/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[](https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie)|[](https://github.com/numpy/numpy/issues?q=is%3Aopen+is%3Aissue+label%3A%22difficulty%3A+Easy%22)|[![elasticsearch](https://avatars2.githubusercontent.com/u/6764390?v=3&s=100)](https://github.com/elastic/elasticsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22low+hanging+fruit%22)| -|---|---|---|---|---|---|---|---| -|[exercism](https://github.com/exercism/exercism.io/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+patch%22)|[Fun Retros](https://github.com/funretro/distributed/issues?q=is%3Aopen+is%3Aissue+label%3A%22beginner+friendly%22)|[react](https://github.com/facebook/react/issues?q=is%3Aissue+is%3Aopen+label%3A%22Difficulty%3A+beginner%22)|[habitat](https://github.com/habitat-sh/habitat/issues?q=is%3Aopen+is%3Aissue+label%3AE-Easy)|[scikit-learn](https://github.com/scikit-learn/scikit-learn/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[Leiningen](https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie)|[numpy](https://github.com/numpy/numpy/issues?q=is%3Aopen+is%3Aissue+label%3A%22difficulty%3A+Easy%22)|[elasticsearch](https://github.com/elastic/elasticsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22low+hanging+fruit%22)| -|[![homebrew](https://avatars2.githubusercontent.com/u/1503512?v=3&s=100)](https://github.com/Homebrew/brew/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22)|[![rust](https://avatars1.githubusercontent.com/u/5430905?v=3&s=100)](https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy)|[![vuejs](https://avatars1.githubusercontent.com/u/6128107?v=3&s=100)](https://github.com/vuejs/vue/issues?q=is%3Aopen+is%3Aissue+label%3A%22contribution+welcome%22)|[![Suave](https://avatars2.githubusercontent.com/u/5822862?v=3&s=100)](https://github.com/SuaveIO/suave/issues?q=is%3Aopen+is%3Aissue+label%3Ahardness-easy)|[![OpenRA](https://avatars3.githubusercontent.com/u/409046?v=3&s=100)](https://github.com/OpenRA/OpenRA/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[![PowerShell](https://avatars0.githubusercontent.com/u/11524380?v=3&s=100)](https://github.com/powershell/powershell/issues?q=is%3Aopen+is%3Aissue+label%3AUp-for-Grabs)|[![coala](https://avatars2.githubusercontent.com/u/10620750?v=3&s=100)](https://github.com/coala/coala/issues?q=is%3Aopen+is%3Aissue+label%3Adifficulty%2Flow+label%3Adifficulty%2Fnewcomer)|[![moment](https://avatars2.githubusercontent.com/u/4129662?v=3&s=100)](https://github.com/moment/moment/issues?q=is%3Aopen+is%3Aissue+label%3AUp-For-Grabs)| -|[homebrew](https://github.com/Homebrew/brew/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22)|[Rust](https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy)|[vuejs](https://github.com/vuejs/vue/issues?q=is%3Aopen+is%3Aissue+label%3A%22contribution+welcome%22)|[Suave](https://github.com/SuaveIO/suave/issues?q=is%3Aopen+is%3Aissue+label%3Ahardness-easy)|[OpenRA](https://github.com/OpenRA/OpenRA/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[PowerShell](https://github.com/powershell/powershell/issues?q=is%3Aopen+is%3Aissue+label%3AUp-for-Grabs)|[coala](https://github.com/coala/coala/issues?q=is%3Aopen+is%3Aissue+label%3Adifficulty%2Flow+label%3Adifficulty%2Fnewcomer)|[moment](https://github.com/moment/moment/issues?q=is%3Aopen+is%3Aissue+label%3AUp-For-Grabs)| -|[![ava](https://avatars0.githubusercontent.com/u/8527916?v=3&s=100)](https://github.com/avajs/ava/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+for+beginner%22)|[![freeCodeCamp](https://avatars0.githubusercontent.com/u/9892522?v=3&s=100)](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only)|[![webpack](https://avatars3.githubusercontent.com/u/2105791?v=3&s=100)](https://github.com/webpack/webpack/issues?q=is%3Aopen+is%3Aissue+label%3A%22D1%3A+Easy+%28Contrib.+Difficulty%29%22)|[![hoodie](https://avatars1.githubusercontent.com/u/1888826?v=3&s=100)](https://github.com/hoodiehq/hoodie/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only)|[![pouchdb](https://avatars3.githubusercontent.com/u/3406112?v=3&s=100)](https://github.com/pouchdb/pouchdb/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+only%22)|[![neovim](https://avatars0.githubusercontent.com/u/6471485?v=3&s=100)](https://github.com/neovim/neovim/issues?q=is%3Aopen+is%3Aissue+label%3Acomplexity%3Alow)|[![babel](https://avatars2.githubusercontent.com/u/9637642?v=3&s=100)](https://github.com/babel/babel/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22) |[](https://github.com/adobe/brackets/issues?q=is%3Aopen+is%3Aissue+label%3A%22Starter+bug%22)| -|[ava](https://github.com/avajs/ava/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+for+beginner%22)|[freeCodeCamp](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only)|[webpack](https://github.com/webpack/webpack/issues?q=is%3Aopen+is%3Aissue+label%3A%22D1%3A+Easy+%28Contrib.+Difficulty%29%22)|[hoodie](https://github.com/hoodiehq/hoodie/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only)|[pouchdb](https://github.com/pouchdb/pouchdb/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+only%22)|[neovim](https://github.com/neovim/neovim/issues?q=is%3Aopen+is%3Aissue+label%3Acomplexity%3Alow)|[babel](https://github.com/babel/babel/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22) |[brackets](https://github.com/adobe/brackets/issues?q=is%3Aopen+is%3Aissue+label%3A%22Starter+bug%22)| -| [![Node.js](https://avatars1.githubusercontent.com/u/9950313?v=3&s=100)](https://github.com/nodejs/node/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)|[](https://github.com/Semantic-Org/Semantic-UI-React/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)| -| [Node.js](https://github.com/nodejs/node/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) |[Semantic-UI-React](https://github.com/Semantic-Org/Semantic-UI-React/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) | diff --git a/additional-material/additional-material.md b/additional-material/additional-material.md index 4b37cf3ed6b..7a125ff0484 100644 --- a/additional-material/additional-material.md +++ b/additional-material/additional-material.md @@ -30,6 +30,17 @@ This document provides information about how to resolve merge conflicts. This document provides information about how to remove a file from your local repository. > Follow these steps to learn how to remove a file prior to a commit +### [ Moving a Commit to a different Branch ](moving-a-commit-to-a-different-branch.md) +This document provides information about how to move a Commit to another Branch. +> Take these steps to move a commit to another branch. + +### [ Configuring git ](configuring-git.md) +This document provides information about how to configure user details and other options in git. +> Use this to better control your git configurations. + ### [Useful Links](Useful-links-for-further-learning.md) This document is dedicated to all the blog posts, helpful sites, tips and tricks websites that makes our lives easier. That we refer to for all our needs, be it a beginner or an expert. This page should act as an index of all those useful links that would help everybody who is new in the open-source domain or someone who wants to learn more. +### [ Squashing Commits ](squashing-commits.md) +This document provides information about how to squash commits with an interactive rebase. +> Use this if you want to open a PR in an open source project and the reviewer asks you to squash every commit into one, with an informative commit message. \ No newline at end of file diff --git a/additional-material/configuring-git.md b/additional-material/configuring-git.md new file mode 100644 index 00000000000..b12bd3e1797 --- /dev/null +++ b/additional-material/configuring-git.md @@ -0,0 +1,76 @@ +## Configuring git + +The first time you tried to commit using git, you might have gotten a prompt like the one below: + +```bash +$ git commit +*** Please tell me who you are. + +Run + +git config --global user.email "you@example.com" +git config --global user.name "Your Name" + +to set your account's default identity. +Omit --global to set the identity only in this repository. +``` + +Git needs to know who you are when you create a commit. When you are working collaboratively, you should be able to see who modified what parts of the project and when, and thus, git has been designed to create commits tied to a name and an email. + +There are multiple ways to provide the `git commit` command with your email and name, and we'll go through some of them below. + +### Global Config + +When you store something in the global config, it is accessible system wide in all the repositories you work on. This is the preferred way and works for most use cases. + +To store something in the global config, you use the `config` command as follows: + +`$ git config --global ` + +In the case of user details, we run it as follows: + +``` +$ git config --global user.email "you@example.com" +$ git config --global user.name "Your Name" +``` + +### Repository Config + +As the name says, these configurations are scoped to your current repository. If you want to commit to a particular repository, say, a work related project, with your company's email, then you could use this method. + +To store something in the repository config, you use the `config` command by emitting the `--global` flag as follows: + +`$ git config ` + +In the case of user details, we run it as follows: + +``` +$ git config user.email "you@alternate.com" +$ git config user.name "Your Name" +``` + +### Command-line Config + +These type of configurations are scoped to the current command only. All git commands take `-c` arguments before the action verb to set temporary configuration data. + +To store something in the command line config, run your command as follows: + +`$ git -c = -c = ` + +In our example, we would run the commit command as follows: + +`git -c user.name='Your Name' -c user.email='you@example.com' commit -m "Your commit message"` + +### Note on Precedence + +Among the three methods described here, the precedence order is `command-line > repository > global`. This means that, if a variable is configured in the command-line as well as globally, the command-line value would be used for the opetaion. + +## Beyond User Details + +We have dealt with only the user details till now while working with the config. However, there are several other configuration options available. Some of them are: + +1. `core.editor` - to specify the name of the editor used for writing commit messages, etc. +2. `commit.template` - to specify a file on the system as the initial commit template. +3. `color.ui` - to specify a boolean value for using colors in git's output. + +We have abstracted some details for ease of understanding. For further reading, head over to [git-scm.com](https://git-scm.com/book/en/v2/Customizing-Git-Git-Configuration). \ No newline at end of file diff --git a/additional-material/moving-a-commit-to-a-different-branch.md b/additional-material/moving-a-commit-to-a-different-branch.md new file mode 100644 index 00000000000..84155f5a254 --- /dev/null +++ b/additional-material/moving-a-commit-to-a-different-branch.md @@ -0,0 +1,26 @@ +## Moving a Commit to a different Branch + +What if you commit a change, and then realize that you commited to a different branch? +How can you change that? This is what this tutorial covers. + +### Moving the lastest commits to an existing Branch +To do this, type: + +```git reset HEAD~ --soft``` - Undoes the last commit, but leave the changes available. +```git stash``` - Records the state of the directory. + +```git checkout name-of-the-correct-branch``` - Swiches to another branch. +```git stash pop``` - Removes lastest stashed state. +```git add .``` - Or try adding individual files. +```git commit -m "your message here"``` - Saves and Commits the changes. + +Now your changes are on the correct branch + + +### Moving the lastest commits to a new Branch +To do this, type: +```git branch newbranch``` - Creates a new Branch. Saving all the Commits. +```git reset --hard HEAD~#``` - Move master back by # commits. Remember, this commits will be gone from master +```git checkout newbranch``` - Goes to the branch you created. It will have all the commits. + +Remember: Any changes not commited will be LOST. diff --git a/additional-material/squashing-commits.md b/additional-material/squashing-commits.md new file mode 100644 index 00000000000..5fc50d56240 --- /dev/null +++ b/additional-material/squashing-commits.md @@ -0,0 +1,86 @@ +# What is squashing? + +In git, squashing refers to rewriting the history of your commits, so you end up with one commit with a description of the changes done. +It's usually done in open source projects because a lot of the history of a branch in open source projects is only relevant to the developer who created it, and this provides a simpler way to describe the changes made and also revert them if needed. + +# How do you squash commits? + +First, perform a git log to review the commits you would like to merge in your current branch. + +``` +git log +``` + +You should see a series of your commits like so: + +``` +commit blablabla +Author: omguhh +Date: 10/10/20 + Commit message 1 + +commit blablabla2 +Author: omguhh +Date: 10/10/20 + Commit message 2 +``` + +So now that you see the commits you wish to merge to one, we can move along into doing that with ```git rebase```. Assuming you're already familiar with ```git rebase```, we can starting squashing commits in the interactive mode of git rebase that you can activate like so: + +``` +git rebase -i +``` + +Now, with interactive rebasing you can specify the starting and end point of how far back you want to go with commits like so: + +``` +git rebase -i HEAD~2 +``` + +Running this command will show you something like the following: + +``` +pick blablabla Changing test01.txt file +pick blablabla2 Adding dummy01.txt file + +# +# Commands: +# p, pick = use commit +# r, reword = use commit, but edit the commit message +# e, edit = use commit, but stop for amending +# s, squash = use commit, but meld into previous commit +# f, fixup = like "squash", but discard this commit's log message +# x, exec = run command (the rest of the line) using shell +# +# These lines can be re-ordered; they are executed from top to bottom. +# +# If you remove a line here THAT COMMIT WILL BE LOST. +# +# However, if you remove everything, the rebase will be aborted. +# +# Note that empty commits are commented out +``` + +So if you want to squash ```blablabla2``` into ```blablablabla```, you would change the following : + +``` +pick blablabla Changing test01.txt file +squash blablabla2 Adding dummy01.txt file + +``` + +If all goes well, you'd get a result that looks like this: + +``` +# This is a combination of 2 commits. +# The first commit's message is: +commit message 1 + +# This is the 2nd commit message: + +commit message 2 +``` + +That you can freely change before you decide to exit the editor to save these changes. + +Running git log again should show you the commit message you entered before exiting the screen with the commits combined into one. \ No newline at end of file diff --git a/additional-material/translations/additional-material.ko.md b/additional-material/translations/additional-material.ko.md new file mode 100644 index 00000000000..f9a2fc3395d --- /dev/null +++ b/additional-material/translations/additional-material.ko.md @@ -0,0 +1,43 @@ +# 추가 정보 + +여러분이 여기에 오기 전에 기본실습 과정을 이미 완료했다고 가정합니다. 이곳에서는 고급 Git 기술에 대한 정보를 제공합니다. + +### [ 여러분의 저장소에서 브랜치 삭제하기 ](removing-branch-from-your-repository.ko.md) +이 문서는 저장소에서 브랜치를 삭제하는 방법에 대한 정보를 제공합니다. +> PR(pull request) 요청이 병합 된 후에 본 단계를 수행하십시오. + +### [ 여러분이 포크한 저장소와 싱크상태 유지하기 ](keeping-your-fork-synced-with-this-repository.ko.md) +이 문서는 포크 된 저장소를 기본 저장소로 최신 상태로 유지하는 방법에 대한 정보를 제공합니다. 여러분과 다른 많은 사람들이 프로젝트에 기여하기를 바랍니다. +> 포크 된 상위 저장소가 변경되지 않은 경우 다음 단계를 수행하십시오. + +### [ 커밋 되돌리기 ](../reverting-a-commit.md) +이 문서는 원격 저장소에서 커밋을 되돌리는 방법에 대한 정보를 제공합니다. 이미 Github에 푸시 된 커밋을 되돌리려는 경우 유용합니다. +> 커밋을 되돌리려면 이 단계를 수행하십시오. + +### [ 커밋 수정하기 ](../amending-a-commit.md) +이 문서는 원격 저장소에서 커밋을 수정하는 방법에 대한 정보를 제공합니다. +> 당신이 만든 커밋을 수정해야 할 때 사용하십시오. + +### [ 로컬 커밋 되돌리기 ](../undoing-a-commit.md) +이 문서는 로컬 저장소에서 커밋을 실행 취소하는 방법에 대한 정보를 제공합니다. 로컬 저장소가 엉망이라고 느껴 당신이 로컬 저장소를 리셋하고자 할 때 당신이 해야 할 일입니다. +> 로컬 커밋을 취소하려면 이 단계를 수행하십시오. + +### [ 병합 충돌 해결하기 ](../resolving-merge-conflicts.md) +이 문서는 병합 충돌을 해결하는 방법에 대한 정보를 제공합니다. +> 이 단계를 수행하여 곤란한 병합 충돌을 해결하십시오. + +### [ 커밋을 다른 브랜치로 이동하기 ](../moving-a-commit-to-a-different-branch.md) +이 문서는 커밋을 다른 브랜치로 이동하는 방법에 대한 정보를 제공합니다. +> 이 단계를 수행하여 커밋을 다른 브랜치로 이동하십시오. + +### [ git 설정하기 ](../configuring-git.md) +이 문서는 git에서 사용자 정보 및 기타 옵션을 구성하는 방법에 대한 정보를 제공합니다. +> git 설정을 더 잘 다루려면 이 단계를 수행하십시오. + +### [ 유용한 링크 ](../Useful-links-for-further-learning.md) +이 문서는 모든 블로그 게시물, 유용한 사이트, 유용한 정보 및 웹 사이트에 대한 내용을 담고 있습니다. 우리가 모든 필요를 위해 참조하는 것은 초심자 또는 전문가 일 것입니다. 이 페이지는 오픈 소스 도메인을 처음 접하거나 더 많은 것을 배우고자 하는 사람들을 돕는 지표 역할을 해야 합니다. + +### [ 스쿼시 커밋하기 ](../squashing-commits.md) +이 문서는 대화형 리베이스로 커밋을 스쿼시하는 방법에 대한 정보를 제공합니다. +> 오픈 소스 프로젝트에서 PR을 보낼 때 리뷰어가 모든 커밋을 하나로 스쿼시하도록 요청하는 경우 유익한 커밋 메시지와 함께 이것을 사용하십시오. + diff --git a/additional-material/translations/keeping-your-fork-synced-with-this-repository.ko.md b/additional-material/translations/keeping-your-fork-synced-with-this-repository.ko.md new file mode 100644 index 00000000000..4e8a424b537 --- /dev/null +++ b/additional-material/translations/keeping-your-fork-synced-with-this-repository.ko.md @@ -0,0 +1,41 @@ +# 여러분이 포크한 저장소와 싱크상태 유지하기 + +먼저, 전체 싱크과정을 이해해야합니다. 본 스키마에는 3개의 저장소들이 있습니다. 저의 GitHub에 있는 제 공개저장소인 `github.com/Roshanjossey/first-contributions/`와 여러분의 포크된 저장소인 `github.com/Your-Name/first-contributions/`, 그리고 로컬 머신에 위치해서 현재 작업중인 저장소가 있습니다. 오픈 소스 프로젝트에 특화된 이러한 조합을 `트라이앵글 워크플로우`라고 부릅니다. + +triangle workflow + +여러분의 두 개의 저장소들을 제 공개 저장소의 최신 상태와 싱크상태를 유지하기 위해서는 제일 먼저여러분의 로컬머신에 위치한 저장소를 제 공개 저장소와 fetch와 merge를 해야합니다. +두번째는 여러분의 로컬 저장소를 포크된 GitHub의 저장소에 push하는 것 입니다. 이전 과정에서 봤듯이 "pull request"를 요청할 수 있는 곳은 오직 포크된 저장소에서만 가능합니다. 따라서 마지막으로 업데이트 되어야하는 저장소는 포크된 GitHub입니다. +자, 어떻게하는지 보겠습니다: +먼저 여러분은 master 브랜치에 위치해 있어야합니다. 현재 어떤 브래치에 있는지 확인합니다.: +``` +git status +``` +현재 master 브랜치가 아니라면 변경합니다.: +``` +git checkout master +``` + +제 공개 저장소를 아직 여러분의 git에 추가하지 않았다면 다음 명령으로 추가합니다. `add upstream remote-url`: +``` +git remote add upstream https://github.com/Roshanjossey/first-contributions +``` +지정한 URL을 이용해 현재 프로젝트의 또 다른 최신 버전이 있는지 git에게 확인을 요청하는 방법입니다. 그리고 우리는 이를 `upstream` 이라고 부르기로합니다. 일단 git이 이러한 이름을 가지고 있다면 다음과 같이 공개 저장소의 최진 버전을 가지고 옵니다. : +``` +git fetch upstream +``` + +여러분은 이제 제 포크(upstream remote)에서 최신 버전을 내려 받았습니다. 이제 공개 저장소의 변경된 내용을 여러분의 master 브랜치에 병합해야합니다. +``` +git rebase upstream/master +``` + +여러분의 master 브랜치와 공개 저장소를 병합하고 나면 이제 여러분의 로컬머신의 master 브랜치는 최신 상태입니다. 마지막으로 여러분의 master 브랜치를 여러분의 포크에 push하게 되면 포크한 GitHub 또한 변경사항들이 반영됩니다.: +``` +git push origin master +``` +origin으로 명명된 리모트에 push하는 것에 주의하세요. +이제 여러분의 모든 저장소가 최신 상태를 유지하게 되었습니다. +잘 하셨습니다! GitHub 저장소에 커밋이 추가적으로 발생할 때마다 이러한 작업을 해야합니다. + + diff --git a/additional-material/translations/removing-branch-from-your-repository.ko.md b/additional-material/translations/removing-branch-from-your-repository.ko.md new file mode 100644 index 00000000000..21370817e04 --- /dev/null +++ b/additional-material/translations/removing-branch-from-your-repository.ko.md @@ -0,0 +1,30 @@ +## 여러분의 저장소에서 브랜치 삭제하기 + +지금까지의 튜토리얼을 수행했다면, 우리의 `` 브랜치가 목적을 완료했습니다. 이제는 로컬 저장소에서 삭제할 차례입니다. 필수사항은 아니지만 이 브랜치의 이름은 다소 특별한 목적을 나타내므로 이미 병합되었다면 그 수명을 다했다고 할 수 있습니다. +First, let's merge your `` to your master, so to go your master branch: +먼저, ``을 마스터에 합쳐야합니다. 마스터 브랜치로 이동합니다.: +``` +git checkout master +``` + +``를 마스터에 병합합니다.: +``` +git merge master +``` + +``를 로컬 저장소에서 삭제합니다.: +``` +git branch -d +``` + +이제 로컬 머신의 ``브랜치를 삭제했고 모든 것이 깔끔하게 보입니다. +이 시점에서 GitHub 포크에 여전히 `` 브랜치가 있어야합니다. 그러나 이것을 삭제하기 전에 이 원격지의 브랜치에서 상위 저장소로 "PR(Pull request)"을 보냈음을 기억하십시오. 따라서 아직 병합되지 않았다면이 브랜치를 삭제하지 마십시오. +그러나 해당 브래치를 이미 병합했고 원격 브랜치를 삭제하려면 다음을 사용하십시오.: +``` +git push origin --delete +``` + +자, 여러분은 이제 자신의 브래치를 정리하는 법을 배웠습니다. +시간이 지나면 많은 커밋이 저장소에 추가됩니다. 그리고 로컬 머신과 GitHub 포크의 마스터 브랜치는 최신 버전이 아닙니다. 따라서 저장소를 내 것과 동기화 된 상태로 유지하려면 아래 단계를 따르십시오. + +#### [ 여러분이 포크한 저장소와 싱크상태 유지하기 ](keeping-your-fork-synced-with-this-repository.ko.md) diff --git a/app/public/index.html b/app/public/index.html index 90e26772fba..868bbbedbee 100644 --- a/app/public/index.html +++ b/app/public/index.html @@ -1,40 +1,40 @@ - - - - - - - First Contributions - - -
- + First Contributions + + +
+ - - - + }); + } + + + diff --git a/app/src/App.jsx b/app/src/App.jsx index ccc4c6561ea..6bf295e539f 100644 --- a/app/src/App.jsx +++ b/app/src/App.jsx @@ -6,19 +6,19 @@ import CardsContainer from './components/ProjectList/CardsContainer'; import SocialShare from './components/SocialShare/SocialShare'; class App extends Component { - render() { - return ( -
- -
-

Make your first open source contribution in 5 minutes

-
- - - -
- ); - } + render() { + return ( +
+ +
+

Make your first open source contribution in 5 minutes

+
+ + + +
+ ); + } } export default App; diff --git a/app/src/components/Navbar/Navbar.jsx b/app/src/components/Navbar/Navbar.jsx index b7da934b06e..f6c5cb91d58 100644 --- a/app/src/components/Navbar/Navbar.jsx +++ b/app/src/components/Navbar/Navbar.jsx @@ -2,15 +2,15 @@ import React, { Component } from 'react'; import './Navbar.css'; class Navbar extends Component { - render() { - return ( -
- GitHub - Twitter - Slack -
- ); - } + render() { + return ( +
+ GitHub + Twitter + Slack +
+ ); + } } export default Navbar; diff --git a/app/src/components/SocialShare/Facebook.jsx b/app/src/components/SocialShare/Facebook.jsx new file mode 100644 index 00000000000..88d1f645a2f --- /dev/null +++ b/app/src/components/SocialShare/Facebook.jsx @@ -0,0 +1,16 @@ +import React from 'react'; +import { Icon, IconPaths } from './icons.js'; + +const facebookLink = "https://www.facebook.com/sharer/sharer.php?u=https://roshanjossey.github.io/first-contributions"e=Yay%21%20I%20just%20made%20my%20first%20open%20source%20contribution%20with%20First%20Contributions.%20You%20can%20too,%20by%20following%20a%20simple%20tutorial%20at%20https%3A//goo.gl/66Axwe" + +const FacebookCard = () => ( + + + +); + +export default FacebookCard; diff --git a/app/src/components/SocialShare/SocialShare.css b/app/src/components/SocialShare/SocialShare.css index 33ec83377a5..ee00d59b287 100644 --- a/app/src/components/SocialShare/SocialShare.css +++ b/app/src/components/SocialShare/SocialShare.css @@ -3,6 +3,7 @@ flex-direction: column; align-items: center; padding: 1em; + background: #4b4949; } #social-share > h2 { @@ -11,24 +12,19 @@ margin-right: .25em; } +#social-shares-container { + display: flex; +} + .icon-card { display: flex; align-items: center; justify-content: center; - width: 136px; - height: 160px; - margin: .25em; - background-color: rgb(255, 255, 255); + width: 90px; + height: 90px; + margin: 1.1em; border-radius: 2px; - box-shadow: rgba(0, 0, 0, 0.12) 0px 1px 6px, rgba(0, 0, 0, 0.12) 0px 1px 4px; - -webkit-transition: box-shadow .1s ease-in-out; - transition: box-shadow .1s ease-in-out; + background: #4b4949; + border: solid white 4px; } -.icon-card:hover{ - box-shadow: rgba(0, 0, 0, 0.16) 0px 3px 10px, rgba(0, 0, 0, 0.23) 0px 3px 10px; -} - -.twitter { - background-color: rgb(29, 202, 255); -} diff --git a/app/src/components/SocialShare/SocialShare.jsx b/app/src/components/SocialShare/SocialShare.jsx index 84637d17f31..18a1ae5145f 100644 --- a/app/src/components/SocialShare/SocialShare.jsx +++ b/app/src/components/SocialShare/SocialShare.jsx @@ -1,12 +1,17 @@ import React from 'react'; import TwitterCard from './Twitter'; +import FacebookCard from './Facebook'; import './SocialShare.css'; const SocialShare = () => ( -
-

Share the news of your first contribution

- -
+
+

Share the news of your first contribution

+
+ + + +
+
); export default SocialShare diff --git a/app/src/components/SocialShare/Twitter.jsx b/app/src/components/SocialShare/Twitter.jsx index 17b846ab1c2..cb2a58532e6 100644 --- a/app/src/components/SocialShare/Twitter.jsx +++ b/app/src/components/SocialShare/Twitter.jsx @@ -4,13 +4,13 @@ import { Icon, IconPaths } from './icons.js'; const twitterLink = "https://twitter.com/intent/tweet?text=Yay%21%20I%20just%20made%20my%20first%20open%20source%20contribution%20with%20@1stcontribution.%20You%20can%20too%20at%20https%3A//goo.gl/66Axwe%0A&hashtags=Hacktoberfest,OpenSource" const TwitterCard = () => ( - - - + + + ); export default TwitterCard; diff --git a/app/src/components/SocialShare/icons.js b/app/src/components/SocialShare/icons.js index 939127642a3..b8773a4370c 100644 --- a/app/src/components/SocialShare/icons.js +++ b/app/src/components/SocialShare/icons.js @@ -2,42 +2,43 @@ import React from 'react'; import PropTypes from 'prop-types'; export const IconPaths = { - twitter: 'M22 4.864c-0.808 0.361-1.68 0.602-2.591 0.709 0.932-0.559 1.646-1.444 1.985-2.496-0.872 0.516-1.839 0.894-2.866 1.096-0.825-0.877-1.998-1.422-3.296-1.422-2.492 0-4.512 2.020-4.512 4.512 0 0.352 0.039 0.696 0.116 1.027-3.751-0.189-7.077-1.985-9.303-4.718-0.387 0.666-0.61 1.444-0.61 2.269 0 1.564 0.795 2.948 2.007 3.755-0.739-0.021-1.435-0.228-2.045-0.563 0 0.017 0 0.039 0 0.056 0 2.187 1.555 4.013 3.622 4.426-0.378 0.103-0.778 0.159-1.19 0.159-0.292 0-0.571-0.030-0.851-0.082 0.576 1.792 2.243 3.098 4.215 3.137-1.547 1.212-3.489 1.934-5.607 1.934-0.365 0-0.722-0.021-1.079-0.064 2.002 1.285 4.374 2.028 6.922 2.028 8.302 0 12.843-6.879 12.843-12.843 0-0.198-0.004-0.391-0.013-0.584 0.881-0.632 1.646-1.427 2.252-2.333z', - github: 'M11 0.272c-6.074 0-11 4.925-11 11 0 4.86 3.152 8.983 7.522 10.438 0.55 0.102 0.752-0.239 0.752-0.529 0-0.262-0.010-1.129-0.015-2.048-3.060 0.666-3.706-1.298-3.706-1.298-0.5-1.271-1.221-1.61-1.221-1.61-0.998-0.683 0.075-0.669 0.075-0.669 1.104 0.078 1.686 1.134 1.686 1.134 0.981 1.682 2.573 1.195 3.201 0.914 0.099-0.711 0.384-1.196 0.698-1.471-2.443-0.278-5.012-1.221-5.012-5.436 0-1.201 0.43-2.182 1.134-2.953-0.114-0.277-0.491-1.396 0.106-2.911 0 0 0.924-0.295 3.026 1.128 0.877-0.244 1.818-0.366 2.753-0.37 0.935 0.004 1.876 0.126 2.755 0.37 2.1-1.423 3.022-1.128 3.022-1.128 0.599 1.515 0.222 2.634 0.108 2.911 0.705 0.77 1.132 1.752 1.132 2.953 0 4.225-2.573 5.155-5.023 5.427 0.395 0.341 0.746 1.011 0.746 2.037 0 1.472-0.013 2.656-0.013 3.019 0 0.293 0.198 0.636 0.756 0.528 4.368-1.456 7.516-5.578 7.516-10.436 0-6.075-4.925-11-11-11z', + twitter: 'M22 4.864c-0.808 0.361-1.68 0.602-2.591 0.709 0.932-0.559 1.646-1.444 1.985-2.496-0.872 0.516-1.839 0.894-2.866 1.096-0.825-0.877-1.998-1.422-3.296-1.422-2.492 0-4.512 2.020-4.512 4.512 0 0.352 0.039 0.696 0.116 1.027-3.751-0.189-7.077-1.985-9.303-4.718-0.387 0.666-0.61 1.444-0.61 2.269 0 1.564 0.795 2.948 2.007 3.755-0.739-0.021-1.435-0.228-2.045-0.563 0 0.017 0 0.039 0 0.056 0 2.187 1.555 4.013 3.622 4.426-0.378 0.103-0.778 0.159-1.19 0.159-0.292 0-0.571-0.030-0.851-0.082 0.576 1.792 2.243 3.098 4.215 3.137-1.547 1.212-3.489 1.934-5.607 1.934-0.365 0-0.722-0.021-1.079-0.064 2.002 1.285 4.374 2.028 6.922 2.028 8.302 0 12.843-6.879 12.843-12.843 0-0.198-0.004-0.391-0.013-0.584 0.881-0.632 1.646-1.427 2.252-2.333z', + github: 'M11 0.272c-6.074 0-11 4.925-11 11 0 4.86 3.152 8.983 7.522 10.438 0.55 0.102 0.752-0.239 0.752-0.529 0-0.262-0.010-1.129-0.015-2.048-3.060 0.666-3.706-1.298-3.706-1.298-0.5-1.271-1.221-1.61-1.221-1.61-0.998-0.683 0.075-0.669 0.075-0.669 1.104 0.078 1.686 1.134 1.686 1.134 0.981 1.682 2.573 1.195 3.201 0.914 0.099-0.711 0.384-1.196 0.698-1.471-2.443-0.278-5.012-1.221-5.012-5.436 0-1.201 0.43-2.182 1.134-2.953-0.114-0.277-0.491-1.396 0.106-2.911 0 0 0.924-0.295 3.026 1.128 0.877-0.244 1.818-0.366 2.753-0.37 0.935 0.004 1.876 0.126 2.755 0.37 2.1-1.423 3.022-1.128 3.022-1.128 0.599 1.515 0.222 2.634 0.108 2.911 0.705 0.77 1.132 1.752 1.132 2.953 0 4.225-2.573 5.155-5.023 5.427 0.395 0.341 0.746 1.011 0.746 2.037 0 1.472-0.013 2.656-0.013 3.019 0 0.293 0.198 0.636 0.756 0.528 4.368-1.456 7.516-5.578 7.516-10.436 0-6.075-4.925-11-11-11z', + facebook: 'M16.5,0l-2.9,0c-3.2,0-5.3,2.1-5.3,5.4v2.5H5.5c-0.2,0-0.4,0.2-0.4,0.4V12c0,0.2,0.2,0.4,0.4,0.4h2.9v9.1 c0,0.2,0.2,0.4,0.4,0.4h3.7c0.2,0,0.4-0.2,0.4-0.4v-9.1h3.4c0.2,0,0.4-0.2,0.4-0.4l0-3.6c0-0.1,0-0.2-0.1-0.3s-0.2-0.1-0.3-0.1H13 V5.8c0-1,0.2-1.5,1.6-1.5l1.9,0c0.2,0,0.4-0.2,0.4-0.4V0.5C16.9,0.2,16.7,0,16.5,0z', }; export const Icon = props => { - const styles = { - svg: { - display: 'block', - margin: '0 auto', - }, - path: { - fill: props.color, - }, - }; + const styles = { + svg: { + display: 'block', + margin: '0 auto', + }, + path: { + fill: props.color, + }, + }; - return ( - - - - ); + return ( + + + +); }; Icon.propTypes = { - icon: PropTypes.string.isRequired, - size: PropTypes.number, - color: PropTypes.string, + icon: PropTypes.string.isRequired, + size: PropTypes.number, + color: PropTypes.string, }; Icon.defaultProps = { - size: 22, + size: 22, }; diff --git a/translations/README.bn.md b/translations/README.bn.md new file mode 100644 index 00000000000..bcdfe6705cb --- /dev/null +++ b/translations/README.bn.md @@ -0,0 +1,118 @@ +[![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) +[](https://firstcontributions.herokuapp.com) +[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) + + +# প্রথম অবদান + +প্রথমবারের মত কোন কাজ করতে গেলে তা কঠিন বলেই মনে হবে। আর আপনি যদি অন্যদের কাজে সহযোগিতা করেন, তাহলে ভুলভ্রান্তিগুলো অত্যন্ত বিব্রতকর। অথচ 'ওপেন সোর্স'-এর মূল বিষয়টিই হচ্ছে পারস্পরিক সহযোগিতা ও একত্রে কাজ করা। আমরা চাই ওপেন সোর্সে অবদান রাখতে ইচ্ছুক নবীনরা যেন সহজেই শিখতে পারে এবং প্রথমবারের মত তাদের অবদান রাখতে পারে। + +প্রবন্ধ পড়ে এবং টিউটোরিয়াল দেখে অনেক কিছুই শেখা যায়, কিন্তু ব্যবহারিক পদ্ধতিতে কাজ করার চেয়ে ভালো কিছু হতে পারে না। এই প্রজেক্টের লক্ষ্য হচ্ছে নবীনদের দিকনির্দেশনা দেওয়া আর সেই সাথে তাদের প্রথম অবদান রাখার কাজটি সহজ করে তোলা। আপনি যদি ওপেন সোর্সে আপনার প্রথম অবদান রাখতে চান, তাহলে নিচের সহজ ধাপগুলো অনুসরণ করুন। কথা দিচ্ছি, এই প্রক্রিয়াটি অত্যন্ত মজার ও অানন্দদায়ক। + +#### *এই লেখাটি [অন্য ভাষা](LANGUAGES.md)য় পড়ুন* + +fork this repository + +আপনার কম্পিউটারে গিট না থাকলে, [ ইনস্টল করুন ]( https://help.github.com/articles/set-up-git/ )। + +## এই রিপোজিটরি ফর্ক করুন + +এই পৃষ্ঠার উপরের অংশে ফর্ক (fork) বাটনে ক্লিক করে এই রিপোজিটরি ফর্ক করুন। +এই প্রক্রিয়ায় আপনার অ্যাকাউন্টে এই রিপোজিটরির একটি কপি তৈরি হবে। + +## রিপোজিটরি ক্লোন করুন + +clone this repository + +এখন এই রিপোটি আপনার কম্পিউটারে ক্লোন করুন। এজন্যে প্রথমে ক্লোন(Clone) বাটনে ক্লিক করুন। এরপর ক্লিক করুন *ক্লিপবোর্ডে কপি করুন(copy to clipboard)* আইকনটিতে। + +টার্মিনাল চালু করুন এবং নিচের কমান্ড রান করুন: + +``` +git clone "url you just copied" +``` +যেখানে "url you just copied" (উদ্ধৃতি চিহ্ণ ব্যতীত) হচ্ছে এই রিপোজিটরির ইউআরএল যা আপনি পূর্বের ধাপেই পেয়েছেন। + +copy URL to clipboard + +উদাহরণ: +``` +git clone https://github.com/this-is-you/first-contributions.git +``` +এখানে `this-is-you` হচ্ছে আপনার গিটহাব ইউজারনেম। এই কমান্ডটির মাধ্যমে গিটহাবে অবস্থিত first-contributions রিপোজিটরির একটি কপি তৈরি হচ্ছে আপনার কম্পিউটারে। + +## একটি ব্রাঞ্চ তৈরি করুন + +আপনার কম্পিউটারে রিপোজিটরির ডিরেক্টরিতে যান (যদি এখনো অন্য ডিরেক্টরিতে থাকেন): + +``` +cd first-contributions +``` +এখন `git checkout` কমান্ডের মাধ্যমে একটি ব্রাঞ্চ তৈরি করুন: +``` +git checkout -b +``` + +উদাহরণ: +``` +git checkout -b add-alonzo-church +``` +(ব্রাঞ্চের নামে *add* শব্দটি যুক্ত থাকা জরুরী নয়। তবে এই ব্রাঞ্চের উদ্দেশ্য যেহেতু আপনার নাম তালিকাভুক্ত করা, সেহেতু *add* শব্দটি যুক্ত থাকাই কাম্য।) + +## প্রয়োজনীয় পরিবর্তন করুন ও পরিবর্তনগুলো কমিট করুন + +এখন যে কোন টেক্সট এডিটরে `Contributors.md` ফাইলটি খুলুন, এতে আপনার নাম যুক্ত করুন, অতঃপর ফাইলটি সেভ করুন। এবার প্রজেক্ট ডিরেক্টরি থেকে `git status` কমান্ড রান করলে আপনি পরিবর্তনগুলো দেখতে পাবেন। `git add` কমান্ড দ্বারা এই পরিবর্তনগুলো আপনার তৈরি ব্রাঞ্চে যুক্ত করুন: +``` +git add Contributors.md +``` + +এরপর `git commit` কমান্ড ব্যবহার করে এই পরিবর্তনগুলো কমিট করুন: +``` +git commit -m "Add to Contributors list" +``` +``-এর বদলে আপনার নাম লিখতে ভুলবেন না। + +## পরিবর্তনগুলো গিটহাবে পুশ করা + +`git push` কমান্ড ব্যবহার করে পরিবর্তনগুলো পুশ করুন: +``` +git push origin +``` +এক্ষেত্রে ``-এর বদলে পূর্বে আপনার তৈরি ব্রাঞ্চের নাম লিখুন। + +## রিভিউয়ের জন্য আপনার পরিবর্তনগুলো জমা দিন + +আপনার গিটহাব রিপোজিটরিতে `Compare & pull request` বাটনে ক্লিক করুন। + +create a pull request + +এখন *পুল রিকোয়েস্ট* সাবমিট করুন। + +submit pull request + +আমি যথা শীঘ্র সম্ভব আপনার পরিবর্তনগুলো এই প্রজেক্টের মাস্টার ব্রাঞ্চে মার্জ করব। মার্জ করা সম্পন্ন হলে আপনি একটি নিশ্চিতকরণ ই-মেইল পাবেন। + +## এরপর কী করব? + +আপনার অবদানের আনন্দ উপভোগ করুন এবং [ওয়েব অ্যাপ](https://roshanjossey.github.io/first-contributions/#social-share)-এর মাধ্যমে বন্ধু ও অনুসরণকারীদের সাথে শেয়ার করুন। + +কোন সহায়তার প্রয়োজন হলে বা আপনার কোন প্রশ্ন থাকলে আপনি আমাদের স্ল্যাক টিমে যুক্ত হতে পারেন। [স্ল্যাক টিমে যোগ দিন](https://firstcontributions.herokuapp.com) + +এখন আপনি অন্যান্য প্রজেক্টগুলোতেও অবদান রাখতে পারেন। আপনার সুবিধার্থে আমরা সহজ সমস্যা সম্বলিত প্রজেক্টগুলোর একটি তালিকা তৈরি করেছি। ওয়েব অ্যাপে [প্রজেক্টগুলোর তালিকা](https://roshanjossey.github.io/first-contributions/#project-list) দেখুন। + +### [ অতিরিক্ত উপাদানসমূহ ](additional-material/additional-material.md) + + +## অন্যান্য টুল ব্যবহারের টিউটোরিয়াল + +|GitHub Desktop|Visual Studio 2017|GitKraken| +|---|---|---| +|[গিটহাব ডেস্কটপ](github-desktop-tutorial.md)|[ভিজুয়াল স্টুডিও ২০১৭](github-windows-vs2017-tutorial.md)|[গিটক্র্যাকেন](gitkraken-tutorial.md)| + +## সেলফ-প্রমোশন + +এই প্রজেক্টটি পছন্দ হলে [গিটহাবে](https://github.com/Roshanjossey/first-contributions) তারকাচিহ্নিত(star) করুন। +এছাড়া আপনি [Roshan](https://roshanjossey.github.io/) কে ফলো করতে পারেন +[টুইটার](https://twitter.com/sudo__bangbang) এবং +[গিটহাব](https://github.com/roshanjossey)-এ। + diff --git a/translations/README.cht.md b/translations/README.cht.md index c9ff6ccf502..4ca54f3c2a1 100644 --- a/translations/README.cht.md +++ b/translations/README.cht.md @@ -16,7 +16,7 @@ ## Fork(複製)本代碼倉庫 點擊圖示中的按鈕去 Fork 這個代碼倉庫。 -這個操作會將代碼倉庫複製到你的賬戶名下。 +這個操作會將代碼倉庫複製到你的Github帳號下。 ## Clone(克隆)代碼倉庫 @@ -61,7 +61,7 @@ git checkout -b add-myname ## 對代碼進行修改,而後 Commit (提交) 修改 -打開 `Contributors.md` 這個文件,更新文件內容,將你的名字加上去,保存修改。`git status` 這命令會列出被改動的文件。接著 `git add` 這命令則可以添加你的改動,就像如下這條命令。 +打開 `Contributors.md` 這個文件,更新文件內容,將你的名字加上去,保存修改。`git status` 這命令會列出被改動的文件。接著 `git add` 這命令則可以添加你的改動,就像以下這條命令。 ``` git add Contributors.md ``` @@ -90,7 +90,8 @@ git push origin <分支的名稱> submit pull request -不久之後,我便會把你所有的變化合併到這個項目的主分支。更改合併後,你會收到通知電郵。 +不久之後,如果你更改的文件與原本沒有衝突,我們會把你所有的變化合併到這個項目的主分支。 +更改合併後,你會收到通知電郵。 ### [ 更多資料 ](additional-material/additional-material.md) @@ -105,7 +106,7 @@ git push origin <分支的名稱> 如果有任何疑問或想獲得更多協助,歡迎加入我們的 [Slack](https://firstcontributions.herokuapp.com)! -通過下面這些鏈接,你能看到當前流行的眾多代碼倉庫中,適合初學者解決的問題列表,還等什麼,去吧 :) +通過下面這些連結,你能看到當前流行的眾多代碼倉庫中,適合初學者解決的問題列表,還等什麼,去吧 :) |[![exercism](https://avatars2.githubusercontent.com/u/5624255?v=3&s=100)](https://github.com/exercism/exercism.io/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+patch%22)|[![fun-retro](https://avatars3.githubusercontent.com/u/15913975?v=3&s=100)](https://github.com/funretro/distributed/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly)|[](https://github.com/facebook/react/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+bug%22)|[![habitat](https://avatars1.githubusercontent.com/u/18171698?v=3&s=100)](https://github.com/habitat-sh/habitat/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[![scikit-learn](https://avatars0.githubusercontent.com/u/365630?v=3&s=100)](https://github.com/scikit-learn/scikit-learn/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[](https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie)|[](https://github.com/numpy/numpy/issues?q=is%3Aopen+is%3Aissue+label%3A%22Easy+Fix%22)|[![elasticsearch](https://avatars2.githubusercontent.com/u/6764390?v=3&s=100)](https://github.com/elastic/elasticsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22low+hanging+fruit%22)| |---|---|---|---|---|---|---|---| diff --git a/translations/README.fr.md b/translations/README.fr.md index 7cc9ce9da2d..467f47fd8c1 100644 --- a/translations/README.fr.md +++ b/translations/README.fr.md @@ -55,11 +55,11 @@ Par exemple: ``` git checkout -b add-koffi-sani ``` -(Le nom de la branch n'a pas besoin de contenir le terme *add*, mais c'est raisonnable de l'inclure parce que l'objectif de cette branche est d'ajouter votre nom à une liste.) +(Le nom de la branche n'a pas besoin de contenir le terme *add*, mais c'est raisonnable de l'inclure parce que l'objectif de cette branche est d'ajouter votre nom à une liste.) ## Effectuez les modifications nécessaires et engagez-les -Maintenant, ouvrez le fichier `Contributors.md` dans un éditeur de texte, ajoutez-y votre nom, et enrégistrez-le. Si vous ouvrez l'invite de commande et vous exécutez la commande `git status`, vous verrez qu'il y a des modifications. Ajoutez ces modifications à la branche que vous venez de créer avec la commande `git add` : +Maintenant, ouvrez le fichier `Contributors.md` dans un éditeur de texte, ajoutez-y votre nom, et enregistrez-le. Si vous ouvrez l'invite de commande et vous exécutez la commande `git status`, vous verrez qu'il y a des modifications. Ajoutez ces modifications à la branche que vous venez de créer avec la commande `git add` : ``` git add Contributors.md ``` @@ -137,7 +137,7 @@ Ceci n'est pas nécessaire, mais le nom de la branche montre que son objectif es ## Où aller ensuite ? -Vous pouvez aussi rejoindre notre équipe sur Slack au cas où vous avec besoin d'aide ou avez des questions. [Rejoindre l'équipe sur Slack](https://firstcontributions.herokuapp.com) +Vous pouvez aussi rejoindre notre équipe sur Slack au cas où vous auriez besoin d'aide ou auriez des questions. [Rejoindre l'équipe sur Slack](https://firstcontributions.herokuapp.com) Voici pour un débutant quelques problèmes que vous pourrez résoudre dans des répertoires populaires. Allez, visitez ces répertoires afin d'en apprendre davantage. diff --git a/translations/README.hi.md b/translations/README.hi.md index e4d6ee1866e..aaf762f3842 100644 --- a/translations/README.hi.md +++ b/translations/README.hi.md @@ -4,19 +4,21 @@ अन्य भाषाओं में इस पढ़ें: [अंग्रेजी](../README.md), [स्पेन](README.es.md), [डच](README.nl.md), [हिंदी](README.hi.md) [जापानी](README.ja.md) [रूसी](README.ru.md) -कठिन होता है| पहली बार कुछ करना हमेशा कठिन होता है| ख़ास तौर पर जब आप सहयोग और गलतियां करना आरामदायक नहीं होता । परन्तु ओपन सोर्स सहयोग के बारे में है । +पहली बार कुछ करना कठिन होता है| ख़ास तौर पर जब आप मिलकर काम कर रहे हों तब गलतियां करना एक अच्छी बात नहीं है| मगर आपस में मिलना और एक जुट होकर काम करना ही तो है ओपन सोर्स| हम आपका ये पहला ओपन सोर्स कॉन्ट्रिब्यूशन आसान बनाने में आपकी मदद करेंगे| + +आर्टिकल्स पढ़ना और ऑनलाइन ट्यूटोरियलज़ देखना मदद कर सकते हैं मगर बिना कुछ गलत करे खुद वो काम करने से अच्छा क्या हो सकता है? यह प्रोजेक्ट आपको आपके पहले कॉन्ट्रिब्यूशन के लिए दिशा निर्देशन में मदद करेगा| याद रखिये - जितने तनाव मुक्त होकर आप सीखेंगे उतना ही बेहतर सीख पाएंगे| अगर आप अपनी पहली कॉन्ट्रिब्यूशन करना चाहते हैं तो आगे दिए गए स्टेप्स को फॉलो करें| अगर आपके मशीन पर Git नहीं है तो, [इसे स्थापित करें](https://help.github.com/articles/set-up-git/) -## कांट इस भंडार +## रिपॉज़िटरी को फॉर्क करना -कांटा बटन पर क्लिक करके इस रेपो कांटा +कांटा बटन पर क्लिक करके इस रिपॉज़िटरी को फॉर्क कर सकते हैं| ## रिपोजिटरी क्लोन clone this repository -अब आप अपने मशीन को यह रेपो क्लोन। क्लोन बटन पर क्लिक करें और फिर कॉपी आइकन क्लिपबोर्ड +अब आप यह रेपो अपने मशीन में क्लोन करें| क्लोन बटन पर क्लिक करें और फिर कॉपी टू क्लिपबोर्ड आइकॉन पर क्लिक करें| एक टर्मिनल खोलें और निम्न git आदेश चलाएँ: @@ -34,17 +36,17 @@ git clone https://github.com/यह तुम हो/first-contributions.git copy URL to clipboard -' यह तुम हो 'अपने GitHub उपयोगकर्ता नाम है। यहाँ आप अपने कंप्यूटर के लिए GitHub में पहली योगदान भंडार की सामग्री नकल कर रहे हैं +' यह तुम हो 'आपके GitHub अकाउंट का नाम है। यहाँ आप अपने कंप्यूटर में GitHub से फर्स्ट-कंट्रिब्यूशंज़ रेपो को क्लोन कर रहे हैं| -## एक शाखा बनाएं +## एक ब्राँच बनाएं -आपके कंप्यूटर पर रिपोजिटरी निर्देशिका के लिए परिवर्तित करें अगर आप पहले से ही वहाँ नहीं कर रहे हैं। +अपने कंप्यूटर में रेपो डायरेक्टरी चेंज करें अगर अभी तक नहीं की है तो -- ``` cd first-contributions ``` -अब एक शाखा बना `git checkout command` उपयोग करके +अब एक शाखा बनाएं `git checkout command` उपयोग करके| ``` git checkout -b <अपना नाम जोड़> @@ -56,89 +58,50 @@ git checkout -b <अपना नाम जोड़> git checkout -b add-alonzo-church ``` -## आवश्यक परिवर्तन करें और उन परिवर्तनों के लिए प्रतिबद्ध +## आवश्यक परिवर्तन करें और उन परिवर्तनों को कमिट करें- -अब खुले `Contributors.md` फ़ाइल एक पाठ संपादक में और इसे आपके नाम जोड़, और फ़ाइल सहेजें। आप अगर इस परियोजना निर्देशिका कर और `git status` करते हैं, तो आप परिवर्तन देखेंगे। उन परिवर्तनों को नीचे `git add` commad का उपयोग कर जोड़ें। +अब `Contributors.md` फ़ाइल को एक टेक्स्ट एडिटर में खोलकर इसमें अपना नाम लिखें, और फ़ाइल को सेव करें| आप अगर `git status` निर्देश चलाएंगे , तो आप परिवर्तन देखेंगे। उन परिवर्तनों को नीचे `git add` कमान्ड का उपयोग कर जोड़ें। ``` git add Contributors.md ``` -अब नीचे `git commit` आदेश का उपयोग उन परिवर्तनों को प्रतिबद्ध है। +अब अपने किये गए बदलावों को कमिट करें `git commit` आदेश का उपयोग करके| ``` git commit -m "Add <आपका-नाम> to Contributors list" ``` -आपके नाम के साथ `<आपका-नाम>` की जगह +<आपका-नाम> की जगह अपना नाम डालें| -## GitHub में परिवर्तन पुश +## अपने बदलावों को github में पुश करें| -`git push` का उपयोग कर अपने परिवर्तन धक्का +`git push` का उपयोग कर अपने परिवर्तन को पुश करें| ``` git push origin <अपना नाम जोड़> ``` -बदलें `<अपना नाम जोड़>` शाखा आपने पहले बनाया के नाम के साथ - -## समीक्षा के लिए अपने परिवर्तनों को जमा करें +`<अपना नाम जोड़>` की जगह अपना नाम डालें| -आप GitHub पर अपने भंडार के लिए जाना है, तो आप देख `Compare & pull request` बटन खींच लेंगे। उस बटन पर क्लिक करें। +## अपने बदलावों को रिव्यु के लिए सबमिट करें| +अगर आप अपने github प्रोफाइल पर अपनी रेपो में जायेंगे तो आपको Compare & pull request का ऑप्शन दिखेगा| उसे दबाएं| create a pull request -अब पुल अनुरोध सबमिट करें। +अब अपनी pull request सबमिट करें| submit pull request +जल्द ही मैं आपके बदलावों को इस प्रोजेक्ट की मास्टर ब्राँच में मर्ज क्र दूंगा| आपको एक मेल आजायेगी जब आपके बदलाव मर्ज होंगे| -## अपने कांटा इस भंडार के साथ समन्वयित रखते हुए - -अब मैं इस परियोजना के मास्टर शाखा में अपने सभी परिवर्तन विलय हो जाएगा। अपने कांटा उन परिवर्तनों की जरूरत नहीं होगी। आदेश में अपने कांटा खान के साथ समन्वयित रखने के लिए, `upstream remote url` के रूप में मेरे रेपो के यूआरएल जोड़ें। - -``` -git remote add upstream https://github.com/multunus/first-contributions -``` - -यह git को इस परियोजना के दूसरे संस्करण निर्दिष्ट यूआरएल में मौजूद बताने का एक तरीका है और हम इसे मास्टर बुला रहे हैं। एक बार परिवर्तन विलय कर रहे हैं, मेरे रिपॉजिटरी के नए संस्करण लाने। - -``` -git fetch upstream -``` - -यहाँ हम अपने कांटा (अपस्ट्रीम दूरदराज) में सभी परिवर्तन ला रहे हैं। अब, आप अपने गुरु शाखा में अपने भंडार के नए संशोधन विलय करने की जरूरत है। - -``` -git rebase upstream/master -``` - -यहाँ आप सभी परिवर्तनों को आप गुरु शाखा को दिलवाया आवेदन कर रहे हैं। तुम अब मास्टर शाखा धक्का, अपने कांटा भी परिवर्तन होगा - -``` -git push origin master -``` - -यहां सूचना आप दूरदराज के नाम पर रखा मूल करने के लिए जोर दे रहे हैं। +## यहाँ से कहाँ जाएं ? +Github पे अपने पहले योगदान की खुश में जश्न मनाएं और अपने दोस्तों के साथ शेयर करें [वेब एप्प](https://roshanjossey.github.io/first-contributions/#social-share) पे जाके|
+आप हमारी स्लैक टीम को ज्वाइन कर सकते हैं अगर आपको कोई मदद चाहिए या आपके कोई परेशानी हों| [स्लैक पे ज्वाइन करें](https://firstcontributions.herokuapp.com)
+अब आप और प्रोजेक्ट्स में कंट्रीब्यूट करना शुरू कर सकते हैं| हमने आपके लिए एक लिस्ट बनायीं है जो कि बहुत आसान मुद्दे हैं| [प्रोजेक्ट्स कि लिस्ट](https://roshanjossey.github.io/first-contributions/#project-list)
## अन्य टूल का उपयोग करके ट्यूटोरियल |GitHub Desktop|Visual Studio 2017|GitKraken| |---|---|---| |[GitHub Desktop](../github-desktop-tutorial.md)|[Visual Studio 2017](../github-windows-vs2017-tutorial.md)|[GitKraken](../gitkraken-tutorial.md)| - - - -## यहाँ से कहाँ जाएं ? - -यहाँ लोकप्रिय रेपो कि आप को हल कर सकते हैं में कुछ शुरुआत के स्तर के मुद्दों है। आगे बढ़ो और अधिक जानने के लिए उन रेपो करने के लिए जाना - -|[![exercism](https://avatars2.githubusercontent.com/u/5624255?v=3&s=100)](https://github.com/exercism/exercism.io/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+patch%22)|[![fun-retro](https://avatars3.githubusercontent.com/u/15913975?v=3&s=100)](https://github.com/funretro/distributed/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly)|[](https://github.com/facebook/react/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+bug%22)|[![habitat](https://avatars1.githubusercontent.com/u/18171698?v=3&s=100)](https://github.com/habitat-sh/habitat/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[![scikit-learn](https://avatars0.githubusercontent.com/u/365630?v=3&s=100)](https://github.com/scikit-learn/scikit-learn/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[](https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie)|[](https://github.com/numpy/numpy/issues?q=is%3Aopen+is%3Aissue+label%3A%22Easy+Fix%22)|[![elasticsearch](https://avatars2.githubusercontent.com/u/6764390?v=3&s=100)](https://github.com/elastic/elasticsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22low+hanging+fruit%22)| -|---|---|---|---|---|---|---|---| -|[exercism](https://github.com/exercism/exercism.io/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+patch%22)|[Fun Retros](https://github.com/funretro/distributed/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly)|[react](https://github.com/facebook/react/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+bug%22)|[habitat](https://github.com/habitat-sh/habitat/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[scikit-learn](https://github.com/scikit-learn/scikit-learn/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[Leiningen](https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie)|[numpy](https://github.com/numpy/numpy/issues?q=is%3Aopen+is%3Aissue+label%3A%22Easy+Fix%22)|[elasticsearch](https://github.com/elastic/elasticsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22low+hanging+fruit%22)| -|[![homebrew](https://avatars2.githubusercontent.com/u/1503512?v=3&s=100)](https://github.com/Homebrew/brew/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22)|[![rust](https://avatars1.githubusercontent.com/u/5430905?v=3&s=100)](https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy)|[![vuejs](https://avatars1.githubusercontent.com/u/6128107?v=3&s=100)](https://github.com/vuejs/vue/issues?q=is%3Aopen+is%3Aissue+label%3A%22contribution+welcome%22)|[![Suave](https://avatars2.githubusercontent.com/u/5822862?v=3&s=100)](https://github.com/SuaveIO/suave/issues?q=is%3Aopen+is%3Aissue+label%3Ahardness-easy)|[![OpenRA](https://avatars3.githubusercontent.com/u/409046?v=3&s=100)](https://github.com/OpenRA/OpenRA/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[![PowerShell](https://avatars0.githubusercontent.com/u/11524380?v=3&s=100)](https://github.com/powershell/powershell/issues?q=is%3Aopen+is%3Aissue+label%3AUp-for-Grabs)|[![coala](https://avatars2.githubusercontent.com/u/10620750?v=3&s=100)](https://github.com/coala/coala/issues?q=is%3Aopen+is%3Aissue+label%3Adifficulty%2Flow+label%3Adifficulty%2Fnewcomer)|[![moment](https://avatars2.githubusercontent.com/u/4129662?v=3&s=100)](https://github.com/moment/moment/issues?q=is%3Aopen+is%3Aissue+label%3AUp-For-Grabs)| -|[homebrew](https://github.com/Homebrew/brew/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22)|[Rust](https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy)|[vuejs](https://github.com/vuejs/vue/issues?q=is%3Aopen+is%3Aissue+label%3A%22contribution+welcome%22)|[Suave](https://github.com/SuaveIO/suave/issues?q=is%3Aopen+is%3Aissue+label%3Ahardness-easy)|[OpenRA](https://github.com/OpenRA/OpenRA/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[PowerShell](https://github.com/powershell/powershell/issues?q=is%3Aopen+is%3Aissue+label%3AUp-for-Grabs)|[coala](https://github.com/coala/coala/issues?q=is%3Aopen+is%3Aissue+label%3Adifficulty%2Flow+label%3Adifficulty%2Fnewcomer)|[moment](https://github.com/moment/moment/issues?q=is%3Aopen+is%3Aissue+label%3AUp-For-Grabs)| -|[![ava](https://avatars0.githubusercontent.com/u/8527916?v=3&s=100)](https://github.com/avajs/ava/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+for+beginner%22)|[![freeCodeCamp](https://avatars0.githubusercontent.com/u/9892522?v=3&s=100)](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only)|[![webpack](https://avatars3.githubusercontent.com/u/2105791?v=3&s=100)](https://github.com/webpack/webpack/issues?q=is%3Aopen+is%3Aissue+label%3A%22D1%3A+Easy+%28Contrib.+Difficulty%29%22)|[![hoodie](https://avatars1.githubusercontent.com/u/1888826?v=3&s=100)](https://github.com/hoodiehq/hoodie/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only)|[![pouchdb](https://avatars3.githubusercontent.com/u/3406112?v=3&s=100)](https://github.com/pouchdb/pouchdb/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+only%22)|[![neovim](https://avatars0.githubusercontent.com/u/6471485?v=3&s=100)](https://github.com/neovim/neovim/issues?q=is%3Aopen+is%3Aissue+label%3Aentry-level)|[![babel](https://avatars2.githubusercontent.com/u/9637642?v=3&s=100)](https://github.com/babel/babel/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) |[](https://github.com/adobe/brackets/labels/Starter%20bug)| -|[ava](https://github.com/avajs/ava/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+for+beginner%22)|[freeCodeCamp](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only)|[webpack](https://github.com/webpack/webpack/issues?q=is%3Aopen+is%3Aissue+label%3A%22D1%3A+Easy+%28Contrib.+Difficulty%29%22)|[hoodie](https://github.com/hoodiehq/hoodie/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only)|[pouchdb](https://github.com/pouchdb/pouchdb/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+only%22)|[neovim](https://github.com/neovim/neovim/issues?q=is%3Aopen+is%3Aissue+label%3Aentry-level)|[babel](https://github.com/babel/babel/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) |[brackets](https://github.com/adobe/brackets/labels/Starter%20bug)| -| [![Node.js](https://avatars1.githubusercontent.com/u/9950313?v=3&s=100)](https://github.com/nodejs/node/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22)|[](https://github.com/Semantic-Org/Semantic-UI-React/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22)| -| [Node.js](https://github.com/nodejs/node/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) |[Semantic-UI-React](https://github.com/Semantic-Org/Semantic-UI-React/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) | diff --git a/translations/README.ko.md b/translations/README.ko.md index c0852d98ee6..dc0062cf01a 100644 --- a/translations/README.ko.md +++ b/translations/README.ko.md @@ -1,11 +1,17 @@ +[![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) +[](https://firstcontributions.herokuapp.com) +[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) + + # 첫 기여 -이 저장소 포크하기 -*Read this in other languages: [English](../README.md), [Spanish](README.es.md), -[Dutch](README.nl.md), [Hindi](README.hi.md), [Russian](README.ru.md), -[Japanese](README.ja.md), [Vietnamese](README.vn.md), [Polish](README.pl.md), -[Korean](README.ko.md), [Greek](README.gr.md).* +힘이 듭니다. 처음으로 뭔가를하는 것은 언제나 어렵습니다. 특히 공동 작업 할 때 실수를 저지르는 것은 쉬운 일이 아닙니다. 그러나 오픈 소스는 협업과 협력에 관한 모든 것입니다. 우리는 새로운 오픈 소스 제공자가 처음 배우고 기여하는 방식을 단순화하고자했습니다. + +기사를 읽고 자습서를 보는 것이 도움이 될 수 있습니다. 그냥 덤벼들었다가 망쳐 놓는 것 보다는 낫겠죠. 이 프로젝트는 초보자가 첫 번째로 기여하는 방법을 안내하고 단순화하는 것을 목표로합니다. 기억하십시오 : 당신이 편안함을 느낄수록 배우는 것이 좋습니다. 첫 번째 기여를 하려면 아래의 간단한 단계를 따르십시오. 재미있을 것이라 약속드립니다. +#### *이 분서를 [다른 언어로 보기](../LANGUAGES.md)* + +이 저장소 포크하기 지금 Git 이 없으면 [설치](https://help.github.com/articles/set-up-git/)하세요. @@ -105,42 +111,17 @@ git push origin 이제 여러분의 변경사항을 제가 확인 후에 마스터 브랜치에 머지하게되면 알림메일을 받으실 수 있습니다. -## 포크한 저장소와 이 저장소 동기화하기 - -이제 나는 이 프로젝트의 마스터 브랜치에 모든 변경사항을 병합할 것 입니다. 당신의 -포크는 그러한 변경사항을 가지고 있지 않습니다. 당신의 포크를 나의 것과 동기화 -하기 위해서, 내 저장소의 주소를 `upstream remote url` 로 추가하세요. - -``` -git remote add upstream https://github.com/multunus/first-contributions -``` - -이것은 명시된 주소에 이 프로젝트의 또 다른 버전이 존재한다는 점을 Git 에 -알려줍니다. 우리는 이것을 업스트림이라고 부릅니다. 변경사항이 병합되면 내 -저장소의 새 버전을 가지고 오세요. - -``` -git fetch upstream -``` - -이거로 내 저장소(업스트림 원격)의 모든 변경사항을 가지고 옵니다. 이제, 내 -저장소의 새 개정판을 당신의 마스터 브랜치에 병합해야 합니다. +## 이제 어디로 가나요? -``` -git rebase upstream/master -``` +여러분의 첫 기여를 축하합니다. 이제 [웹 앱](https://roshanjossey.github.io/first-contributions/#social-share)으로 이동하여 친구 및 팔로워와 공유하십시오. -여기서 당신이 가져온 모든 변경사항을 마스터 브랜치에 적용됩니다. 마스터 브랜치를 -푸시하면, 당신의 포크도 역시 변경사항을 가질 것 입니다. +도움이 필요하거나 질문이있을 경우, 우리의 slack 팀에 합류 할 수 있습니다. [slack 팀 가입하기](https://firstcontributions.herokuapp.com). -``` -git push origin master -``` +이제 다른 프로젝트에 기여해보십시오. 시작하기 쉬운 문제가있는 프로젝트 목록을 작성했습니다. [웹 앱에 있는 프로젝트 목록](https://roshanjossey.github.io/first-contributions/#project-list)을 확인하세요. -origin 이라 명명된 원격으로 푸시하고 있는 것에 주목하세요. -### [ 추가 정보 ](additional-material/additional-material.ko.md) +### [ 추가 정보 ](../additional-material/translations/additional-material.ko.md) ## 자습서 다른 도구 사용 @@ -148,18 +129,8 @@ origin 이라 명명된 원격으로 푸시하고 있는 것에 주목하세요. |---|---|---| |[GitHub Desktop](../github-desktop-tutorial.md)|[Visual Studio 2017](../github-windows-vs2017-tutorial.md)|[GitKraken](../gitkraken-tutorial.md)| +## Self-Promotion -## 이제 어디로 가나요? +본 프로젝트가 마음에 드신다면, [GitHub](https://github.com/Roshanjossey/first-contributions)를 star버튼을 눌러주세요. -이곳의 인기있는 저장소에 당신이 해결할 수 있는 초보자 수준의 문제들이 있습니다. -더 자세히 알아보기 위해 해당 저장소를 방문해보세요. - -|[![exercism](https://avatars2.githubusercontent.com/u/5624255?v=3&s=100)](https://github.com/exercism/exercism.io/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+patch%22)|[![fun-retro](https://avatars3.githubusercontent.com/u/15913975?v=3&s=100)](https://github.com/funretro/distributed/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly)|[](https://github.com/facebook/react/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+bug%22)|[![habitat](https://avatars1.githubusercontent.com/u/18171698?v=3&s=100)](https://github.com/habitat-sh/habitat/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[![scikit-learn](https://avatars0.githubusercontent.com/u/365630?v=3&s=100)](https://github.com/scikit-learn/scikit-learn/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[](https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie)|[](https://github.com/numpy/numpy/issues?q=is%3Aopen+is%3Aissue+label%3A%22Easy+Fix%22)|[![elasticsearch](https://avatars2.githubusercontent.com/u/6764390?v=3&s=100)](https://github.com/elastic/elasticsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22low+hanging+fruit%22)| -|---|---|---|---|---|---|---|---| -|[exercism](https://github.com/exercism/exercism.io/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+patch%22)|[Fun Retros](https://github.com/funretro/distributed/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly)|[react](https://github.com/facebook/react/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+bug%22)|[habitat](https://github.com/habitat-sh/habitat/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[scikit-learn](https://github.com/scikit-learn/scikit-learn/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[Leiningen](https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie)|[numpy](https://github.com/numpy/numpy/issues?q=is%3Aopen+is%3Aissue+label%3A%22Easy+Fix%22)|[elasticsearch](https://github.com/elastic/elasticsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22low+hanging+fruit%22)| -|[![homebrew](https://avatars2.githubusercontent.com/u/1503512?v=3&s=100)](https://github.com/Homebrew/brew/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22)|[![rust](https://avatars1.githubusercontent.com/u/5430905?v=3&s=100)](https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy)|[![vuejs](https://avatars1.githubusercontent.com/u/6128107?v=3&s=100)](https://github.com/vuejs/vue/issues?q=is%3Aopen+is%3Aissue+label%3A%22contribution+welcome%22)|[![Suave](https://avatars2.githubusercontent.com/u/5822862?v=3&s=100)](https://github.com/SuaveIO/suave/issues?q=is%3Aopen+is%3Aissue+label%3Ahardness-easy)|[![OpenRA](https://avatars3.githubusercontent.com/u/409046?v=3&s=100)](https://github.com/OpenRA/OpenRA/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[![PowerShell](https://avatars0.githubusercontent.com/u/11524380?v=3&s=100)](https://github.com/powershell/powershell/issues?q=is%3Aopen+is%3Aissue+label%3AUp-for-Grabs)|[![coala](https://avatars2.githubusercontent.com/u/10620750?v=3&s=100)](https://github.com/coala/coala/issues?q=is%3Aopen+is%3Aissue+label%3Adifficulty%2Flow+label%3Adifficulty%2Fnewcomer)|[![moment](https://avatars2.githubusercontent.com/u/4129662?v=3&s=100)](https://github.com/moment/moment/issues?q=is%3Aopen+is%3Aissue+label%3AUp-For-Grabs)| -|[homebrew](https://github.com/Homebrew/brew/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22)|[Rust](https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy)|[vuejs](https://github.com/vuejs/vue/issues?q=is%3Aopen+is%3Aissue+label%3A%22contribution+welcome%22)|[Suave](https://github.com/SuaveIO/suave/issues?q=is%3Aopen+is%3Aissue+label%3Ahardness-easy)|[OpenRA](https://github.com/OpenRA/OpenRA/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[PowerShell](https://github.com/powershell/powershell/issues?q=is%3Aopen+is%3Aissue+label%3AUp-for-Grabs)|[coala](https://github.com/coala/coala/issues?q=is%3Aopen+is%3Aissue+label%3Adifficulty%2Flow+label%3Adifficulty%2Fnewcomer)|[moment](https://github.com/moment/moment/issues?q=is%3Aopen+is%3Aissue+label%3AUp-For-Grabs)| -|[![ava](https://avatars0.githubusercontent.com/u/8527916?v=3&s=100)](https://github.com/avajs/ava/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+for+beginner%22)|[![freeCodeCamp](https://avatars0.githubusercontent.com/u/9892522?v=3&s=100)](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only)|[![webpack](https://avatars3.githubusercontent.com/u/2105791?v=3&s=100)](https://github.com/webpack/webpack/issues?q=is%3Aopen+is%3Aissue+label%3A%22D1%3A+Easy+%28Contrib.+Difficulty%29%22)|[![hoodie](https://avatars1.githubusercontent.com/u/1888826?v=3&s=100)](https://github.com/hoodiehq/hoodie/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only)|[![pouchdb](https://avatars3.githubusercontent.com/u/3406112?v=3&s=100)](https://github.com/pouchdb/pouchdb/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+only%22)|[![neovim](https://avatars0.githubusercontent.com/u/6471485?v=3&s=100)](https://github.com/neovim/neovim/issues?q=is%3Aopen+is%3Aissue+label%3Aentry-level)|[![babel](https://avatars2.githubusercontent.com/u/9637642?v=3&s=100)](https://github.com/babel/babel/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) |[](https://github.com/adobe/brackets/labels/Starter%20bug)| -|[ava](https://github.com/avajs/ava/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+for+beginner%22)|[freeCodeCamp](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only)|[webpack](https://github.com/webpack/webpack/issues?q=is%3Aopen+is%3Aissue+label%3A%22D1%3A+Easy+%28Contrib.+Difficulty%29%22)|[hoodie](https://github.com/hoodiehq/hoodie/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only)|[pouchdb](https://github.com/pouchdb/pouchdb/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+only%22)|[neovim](https://github.com/neovim/neovim/issues?q=is%3Aopen+is%3Aissue+label%3Aentry-level)|[babel](https://github.com/babel/babel/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) |[brackets](https://github.com/adobe/brackets/labels/Starter%20bug)| -| [![Node.js](https://avatars1.githubusercontent.com/u/9950313?v=3&s=100)](https://github.com/nodejs/node/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22)|[](https://github.com/Semantic-Org/Semantic-UI-React/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22)| -| [Node.js](https://github.com/nodejs/node/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) |[Semantic-UI-React](https://github.com/Semantic-Org/Semantic-UI-React/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) | +특히 도움이 되고자하신다면 [Twitter](https://twitter.com/sudo__bangbang) 와 [GitHub](https://github.com/roshanjossey)의 [Roshan](https://roshanjossey.github.io/)을 follow해주세요. diff --git a/translations/README.nl.md b/translations/README.nl.md index c9e15cac40c..5c35e2b76e5 100644 --- a/translations/README.nl.md +++ b/translations/README.nl.md @@ -9,7 +9,7 @@ Het kan helpen om de artikelen te lezen en de video's te bekijken, maar niets is fork this repository -#### *Lees dit in [andere talen](LANGUAGES.md)* +#### *Lees dit in [andere talen](../LANGUAGES.md)* Indien je git nog niet hebt op je systeem, [ installeer het dan eerst ]( https://help.github.com/articles/set-up-git/ ) diff --git a/translations/README.pt_br.md b/translations/README.pt_br.md index 733b47d4ef9..09bb9031246 100644 --- a/translations/README.pt_br.md +++ b/translations/README.pt_br.md @@ -85,7 +85,7 @@ Agora envie um Pull Request. Logo estarei mesclando as suas mudanças no Branch principal (master) deste projeto. Você receberá um e-mail de notificação quando as alterações forem mescladas. -### [ Material adicional ](additional-material/translations/additional-material.pt_br.md) +### [ Material adicional ](../additional-material/translations/additional-material.pt_br.md) ## Tutoriais com outras ferramentas diff --git a/translations/README.ro.md b/translations/README.ro.md new file mode 100644 index 00000000000..3587bbf10fc --- /dev/null +++ b/translations/README.ro.md @@ -0,0 +1,118 @@ +[![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) +[](https://firstcontributions.herokuapp.com) +[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) + + +# Primele Contribuții + +Este greu. Este întotdeauna greu când faci ceva pentru prima dată. Mai ales când colaborezi. A face greșeli nu este un lucru confortabil. Dar cel mai important în open source este colaborarea și lucrul în echipă. Noi am vrut să simplificăm modul în care noii contribuabili în open source învață și contribuie pentru prima dată. + +Citirea articolelor și vizionarea tutorialelor poate ajuta, dar ce este mai bine decât să faci lucrurile fără a strica ceva? Acest proiect își propune să ofere îndrumare și simplificarea modului în care începătorii își fac prima contribuție. Amintește-ți: cu cât ești mai relaxat, cu atât mai bine înveți. Dacă dorești să faci prima ta contribuție, simplu urmați pașii de mai jos. Vă promit că va fi distractiv. + +#### *Citește în [alte limbi](LANGUAGES.md)* + +fork this repository + +Dacă nu ai git instalat, [ instalează-l ]( https://help.github.com/articles/set-up-git/ ). + +## Ramifică repozitoriul(depozit) + +Ramifică acest repo(depozit) făcând clic pe butonul fork locat pe partea de sus a paginii. +Acesta va creea o copie a repozitoriului în contul tău. + +## Clonează repozitoriul(depozit) + +clone this repository + +Acum clonează acest repo pe mașina ta. Fă clic pe butonul clone apoi clic pe *copiați în clipboard*. + +Deschideți un terminal și executați următoarea comanda git: + +``` +git clone "adresa copiată" +``` +Unde "adresa copiată" (Fără de ghilimele) este adresa repozitorului. Vezi pașii anteriori pentru a obține adresa. + +copy URL to clipboard + +De exemplu: +``` +git clone https://github.com/acesta-ești-tu/prima-contribuție.git +``` +Unde `acesta-ești-tu` este numele tău GitHub. Aici tu copii conținutul repozitorului GitHub "prima-contribuție" pe computerul tău. + +## Creează o Ramură + +Schimbați directorul în repozitoriu pe computer (dacă nu sunteți deja acolo): + +``` +cd prima-contribuție +``` +Acum creați o ramură cu ajutorul comenzii `git checkout`: +``` +git checkout -b +``` + +De exemplu: +``` +git checkout -b adaug-alonzo-church +``` +(Numele ramurii nu e obligatoriu să fie *adaug*, dar e un lucru rezonabil pentru a include deoarece scopul acestei ramure este de a adăuga numele tău în lista!) + +## Fă schimbările necesare si comite aceste schimbări + +Acum deschide fișierul `Contributors.md` într-un editor de text (ca NotePad, Vim, nano, emacs, etc.), adaugă numele tău în el, apoi salvează fișierul. Dacă accesezi directorul de proiect și execuți comanda `git status`, vei vedea schimbări. Adaugă acele schimbări la ramura creată de tine cu comanda `git add`: +``` +git add Contributors.md +``` + +Acum comite acele schimbări cu comanda `git commit`: +``` +git commit -m "Adaug la lista de contribuitori" +``` +Schimbând `` cu numele tău. + +## Împinge Schimbările pe GitHub + +Împinge schimbările tale cu comanda `git push`: +``` +git push origin +``` +Schimbând `` cu numele ramurii create de tine anterior. + +## Trimite modificările pentru examinare + +Dacă pleci la repozitoriul tău de pe GitHub, vei vedea butonul `Compare & pull request`(Compară & trage cererea). Fă clic pe el. + +create a pull request + +Acum Trimiteți solicitarea de tragere. + +submit pull request + +Curând Eu voi îmbina toate schimbările în ramura principală a acestui proiect. Veți primi un e-mail de notificare odată ce schimbările au fost fuzionate. + +## De unde să mergi de aici? + +Sărbătați-vă contribuția și împărtășiți-o cu prietenii și adepții dvs. accesând [aplicația web](https://roshanjossey.github.io/first-contributions/#social-share). + +Ați putea să vă alăturați echipei noastre în cazul în care aveți nevoie de ajutor sau aveți întrebări. [Alaturăte echipei Slack](https://firstcontributions.herokuapp.com). + +Acum, să începem să contribuiți la alte proiecte. Am compilat o listă de proiecte cu probleme ușoare pe care le puteți începe. Verifică [lista de proiecte in aplicația web](https://roshanjossey.github.io/first-contributions/#project-list). + +### [ Additional material ](additional-material/additional-material.md) + + +## Tutorials Using Other Tools + +|GitHub Desktop|Visual Studio 2017|GitKraken| +|---|---|---| +|[GitHub Desktop](github-desktop-tutorial.md)|[Visual Studio 2017](github-windows-vs2017-tutorial.md)|[GitKraken](gitkraken-tutorial.md)| + +## Self-Promotion + +Dacă ți-a plăcut acest proiect, pune-i o stea pe [GitHub](https://github.com/Roshanjossey/first-contributions). +Dacă vă simțiți deosebit de caritabili, urmați-mă [Roshan](https://roshanjossey.github.io/) pe +[Twitter](https://twitter.com/sudo__bangbang) și +[GitHub](https://github.com/roshanjossey). +