Roshanjossey
14 KiB
ఓపెన్సోర్స్కు మీ మొదటి సహకారం
వ్యాసాలు చదవడం & చూడటం ట్యుటోరియల్స్ సహాయపడతాయి, కానీ వాస్తవంగా ఆచరణాత్మక వాతావరణంలో నేర్పిస్తున్నదాని కంటే మెరుగైనది ఏమిటి?
మార్గదర్శిని అందించడం మరియు ఈ ప్రాజెక్ట్ ప్రారంభకులకు వారి మొదటి ఓపెన్ సోర్స్ సహకారం అందించే విధానాన్ని సరళీకరించడం మరియు మార్గనిర్దేశం చేయడం లక్ష్యంగా పెట్టుకుంది. మీరు మీ మొదటి ఓపెన్ సోర్స్స హకారం అందించాలని చూస్తున్నట్లయితే, దిగువ దశలను అనుసరించండి.
మీకు ఆదేశ పంక్తితో సౌకర్యంగా లేకపోతే, ఇక్కడ GUI సాధనాలను ఉపయోగించి ట్యుటోరియల్స్ ఉన్నాయి.
మొదటిసారి ఓపెన్ సోర్స్ కొరకు సహకరించాలి అనుకునే ప్రారంభకులకు పద్దతులను సులభతరం చేయడం ఈ ప్రాజెక్ట్ ముఖ్య ఉద్దేశం
మీరు మొదటిసారి ఒపెన్ సోర్స్ ప్రాజెక్ట్ లకొరకు కాంట్రిబ్యూట్ చేయాలి అనుకుంటే కింది సూచనలు పాటించండి.
మీరు గిట్(git)వర్షన్ కట్రోల్ సిస్టమ్ తో సౌకర్యవంతంగా లేకపోతే ఇక్కడ GUI సాధనాలను ఉపయోగించి ట్యుటోరియల్స్ ఉన్నాయి.*
మీ కంప్యూటర్ లో GIT లేకపోతే, గిట్ వర్షన్ కంట్రోల్ సిస్టమ్ ను ఇన్స్టాల్ చేయండి.
ఈ రిపోజిటరీని ఫోర్క్ చెయ్యండి
ఈ రిపోజిటరీని ఫోర్క్ చెయ్యండి ఈ పేజీ ఎగువ భాగంలో ఫోర్క్ బటన్ పై క్లిక్ చేయడం ద్వారా క్లిక్ చేయండి. ఇది మీ ఖాతాలో ఈ రిపోజిటరీ కాపీని సృష్టిస్తుంది.
ఈ రిపోజిటరీని క్లోన్ చెయ్యండి
ఇప్పుడు మీ కంప్యూటరులో ఫోర్క్ రిపోను క్లోన్ చేయండి. మీ GitHub ఖాతాకు వెళ్లండి, ఫోర్క్డ్ రెపోని తెరిచి, క్లోన్ బటన్పై క్లిక్ చేసి, ఆపై * కాపీ * క్లిప్బోర్డ్కు క్లిక్ చేయండి.
టెర్మినల్ తెరిచి కింది git ఆదేశాన్ని అమలు చేయండి:
git clone "మీరు ఇప్పుడే కాపీ చేసిన url"
ఇక్కడ "మీరు ఇప్పుడే కాపీ చేసిన url" (కోట్ మార్కులు లేకుండా) ఈ రిపోజిటరీకి URL (ఈ ప్రాజెక్టు మీ ఫోర్క్). Url ను పొందడానికి మునుపటి దశలను చూడండి.
ఉదాహరణకి:
git clone https://github.com/this-is-you/first-contributions.git
ఇక్కడ 'this-is-you' మీ GitHub ప్రొఫైల్ నేమ్. ఇక్కడ మీరు first-contribution రిపోజిటరీ యొక్క కంటెంట్లను మీ GitHub అకౌంట్ లో మీ కంప్యూటర్కు కాపీ చేస్తున్నారు.
నూతన బ్రాంచ్ ను సృష్టించండి
మీ కంప్యూటర్లోని రిపోజిటరీ డైరెక్టరీకి మార్చండి (మీరు ఇప్పటికే అక్కడ లేకపోతే):
cd first-contributions
ఇప్పుడు 'git checkout' కమాండ్ ను ఉపయోగించి ఒక బ్రాంచ్ ను సృష్టించండి:
ఉదాహరణకి:
git checkout -b add-alonzo-church
(బ్రాంచ్ యొక్క పేరు దానిలో పదం * add * ను కలిగి ఉండవలసిన అవసరం లేదు.
అవసరమైన మార్పులు - చేర్పులు చేసి, ఆ మార్పులను నిరూపించండి.
టెక్స్ట్ ఎడిటర్లో ఇప్పుడు ఓపెన్ Contributors.md ఫైల్లో, మీ పేరుని జోడించండి. ఫైల్ ప్రారంభంలో లేదా ముగింపులో జోడించవద్దు. మధ్యలో ఎక్కడైనా ఉంచండి. ఇప్పుడు, ఫైల్ను సేవ్ చేయండి.
మీరు ప్రాజెక్ట్ డైరెక్టరీకి వెళ్లి git status కమాండ్ ని ఆదేశిస్తే, మార్పులు-చేర్పులు ఉన్నాయి అని మీరు చూస్తారు.
Git add కమాండ్ ను ఉపయోగించి మీరు సృష్టించిన బ్రాంచ్లో ఈ మార్పులను జోడించండి.
Git add కమాండ్ను ఉపయోగించి మీరు సృష్టించిన బ్రాంచ్లో ఈ మార్పులను జోడించండి:
git add Contributors.md
ఇప్పుడు ఆ మార్పులను 'git commit' ఆదేశం ఉపయోగించి కట్టుకోండి:
git commit -m "Add <your-name> to Contributors list"
<your-name> ని తొలగించి మీ పేరును కలపండి.
GitHubకి మార్పులను పుష్ చేయండి
కమాండ్ ఉపయోగించి మీ మార్పులను పంపండి git push:
git push origin <add-your-branch-name>
మీరు ముందుగా సృష్టించిన బ్రాంచీ పేరుతో <add-your-branch-name> ను జోడించుము.
GitHubలోకి నెట్టేటప్పుడు మీకు ఏవైనా లోపాలు వస్తే, ఇక్కడ క్లిక్ చేయండి:
-
ప్రమాణీకరణ లోపం
remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead. remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information. fatal: Authentication failed for 'https://github.com//first-contributions.git/'
మీ ఖాతాకు SSH కీని రూపొందించడం మరియు కాన్ఫిగర్ చేయడంపై GitHub's tutorial వెళ్లండి.
సమీక్ష కోసం మీ మార్పులను సమర్పించండి
మీరు GitHub లో మీ రిపోజిటరీకి వెళ్లినట్లయితే, మీరు 'Compare & pull request' బటన్ను చూస్తారు. ఆ బటన్పై క్లిక్ చేయండి.
ఇప్పుడు పుల్ అభ్యర్థనను సమర్పించండి.
నేను మీ అన్ని మర్పులను ఈ ప్రాజెక్ట్ యొక్క ప్రధాన విభాగానికి విలీనంmerge to main branch చేస్తాను.
మార్పులు విలీనంmerge అయిన తర్వాత మీరు ఒక నోటిఫికేషన్ ఈమెయిల్ పొందుతారు.
ఇక్కడ నుండి ఎక్కడికి వెళ్లాలి?
అభినందనలు! మీరు స్టాండర్డ్ fork -> clone -> edit -> PR వర్క్ ఫ్లో ను పూర్తి చేసారు.
వెబ్ యాప్కి వెళ్లడం ద్వారా మీ సహకారాన్ని జరుపుకోండి మరియు మీ స్నేహితులు మరియు అనుచరులతో భాగస్వామ్యం చేయండి.
మీకు ఏదైనా సహాయం అవసరమైతే లేదా ఏవైనా ప్రశ్నలు ఉంటే మీరు మా స్లాక్ టీమ్లో చేరవచ్చు.స్లాక్ జట్టులో చేరండి
ఇక, ఇప్పుడు మీరు ఇతర ప్రాజెక్టులకు తోడ్పడటం ప్రారంభించండి. మీరు ప్రారంభించగల సులభమైన సమస్యలతో ప్రాజెక్టుల జాబితాను మేము రెడీ చేసాము. వెబ్ ప్రాజెక్టుల జాబితాలు ను చూడండి.
అదనపు విషయం
ఇతర సాధనాలను ఉపయోగించి ట్యుటోరియల్స్
 |
 |
 |
 |
 |
 |
|---|---|---|---|---|---|
| GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code | Atlassian Sourcetree | IntelliJ IDEA |