⚠️ This translation is outdated. It describes an older workflow that no longer works. Please follow the up-to-date English tutorial instead.
ఈ మార్గదర్శిని సమాజ ప్రయోజనార్థం ఈ ప్రాజెక్ట్ నిర్వహణ మరియు సంరక్షణలో భాగస్వామ్యం కావాలనుకునే వారికి ఉద్దేశించబడింది.
మీరు ఈ ప్రాజెక్ట్లో Maintainer గా చేరాలనుకుంటే, ఈ గైడ్ మీకు సహాయపడుతుంది.
(ఇది మొదటిసారి సహకారం చేసే వారి కోసం గైడ్ కాదు.)
ఈ ట్యుటోరియల్ ఇతర భాషల్లో కూడా అందుబాటులో ఉంది.
ప్రాజెక్ట్ డాక్యుమెంటేషన్ అనువాదాలకు స్వాగతం.
సహకరించాలనుకుంటే దయచేసిTranslation Guideచదవండి.
మా ప్రధాన లక్ష్యం ఏమిటంటే —
ఏదైనా సహకారుడు (Contributor) తన Pull Request సమర్పించిన వెంటనే, అతనికి/ఆమెకు త్వరితమైన మరియు ఉపయోగకరమైన స్పందన అందించడం.
దీనిలో ప్రధానంగా:
- కోడ్ రివ్యూ చేయడం
- ఆమోదించబడిన PRలను merge చేయడం
అదనంగా, Maintainer గా మీరు:
- ప్రాజెక్ట్ సక్రమంగా పనిచేస్తుందో లేదో నిర్ధారించాలి
- ప్రాజెక్ట్ను సవ్యంగా, ఉపయోగకరంగా మరియు సులభంగా నిర్వహించదగిన విధంగా ఉంచాలి
ఈ గైడ్ Git మరియు GitHub గురించి ప్రాథమిక అవగాహన ఉన్నవారికి ఉద్దేశించబడింది.
నిపుణుడు కావాల్సిన అవసరం లేదు —
ప్రారంభ దశలో ఉన్నవారికి కూడా ఈ గైడ్ ఉపయోగపడేలా రూపొందించబడింది.
ఇది ఒక సక్రియమైన ప్రాజెక్ట్. ఇక్కడ నియమితంగా కొత్త సహకారాలు వస్తుంటాయి.
అనేక మంది తమ మొదటి ఓపెన్ సోర్స్ సహకారాన్ని ఇక్కడే ప్రారంభిస్తారు.
Maintainer గా మీ పాత్ర:
- కొత్త సహకారులకు సానుకూల అనుభవం కల్పించడం
- వారిని భవిష్యత్తులో కూడా సహకారం చేయడానికి ప్రోత్సహించడం
మీ సమయం, మీ అందుబాటును బట్టి మీరు సహకరించవచ్చు —
కొద్దిగా అయినా, ఎక్కువైనా.
సమూహ కృషితో ఈ ప్రాజెక్ట్ను ముందుకు తీసుకువెళ్లవచ్చు.
- ప్రాజెక్ట్లోని Pull Requests విభాగానికి వెళ్లండి.
- Changes Requested స్థితిలో లేని పాత PR నుండి ప్రారంభించండి.
- PRను ఓపెన్ చేసి, Files Changed ట్యాబ్కి వెళ్లి కోడ్ రివ్యూ ప్రారంభించండి.
- ఆ PR ట్యుటోరియల్లో పేర్కొన్న నియమాలు మరియు ప్రమాణాలను అనుసరిస్తుందో లేదో చూసుకోండి.
- HTML, లింకులు మరియు డేటా సరైనవో కాదో నిర్ధారించండి.
- కార్డ్ ఫైల్ సరైన స్థానంలో జోడించబడిందో లేదో పరిశీలించండి.
- Merge Conflict ఉన్నాయా అని తనిఖీ చేయండి. అవసరమైతే
masterబ్రాంచ్ను PR బ్రాంచ్లో merge చేసి సమస్య పరిష్కరించండి. - సాధారణంగా ఫోర్క్ పాతదైపోయినప్పుడు లేదా ఒకే భాగంలో అనేక PRలు మార్పులు చేసినప్పుడు conflictలు వస్తాయి.
- Conflict పరిష్కరించే సమయంలో, కొత్త కార్డ్ను ఫోర్క్ అయిన తర్వాత జోడించబడిన కార్డ్లకు పైభాగంలో ఉంచండి.
- అన్నీ సరిగా ఉంటే PRను approve చేసి, సహకారుడికి ధన్యవాద సందేశం పంపండి.
గుర్తుంచుకోండి — చాలా మంది ఇది వారి మొదటి సహకారం. ప్రోత్సాహం వారికి చాలా ముఖ్యం. - చివరగా PRను
masterబ్రాంచ్లో merge చేయండి.
కొన్నిసార్లు PRలో సవరించాల్సిన లోపాలు ఉండవచ్చు. ఉదాహరణకు:
- తప్పు బ్రాంచ్ ఉపయోగించడం
- తప్పుగా ఉన్న HTML
- అసంపూర్ణ సమాచారం
- తప్పు స్థానంలో జోడించబడిన కార్డ్
ఇవి సాధారణ merge conflictలు కాకపోతే:
- GitHub లో కోడ్ రివ్యూ ప్రారంభించి Request Changes ఎంపికను ఎంచుకోండి.
- స్పష్టమైన మరియు ఖచ్చితమైన వ్యాఖ్య ఇవ్వండి.
- సమస్య ఏమిటి? దాన్ని ఎలా పరిష్కరించాలి? — వివరించండి.
- ఇది సాధారణ రివ్యూ ప్రక్రియలో భాగమని సహకారుడికి తెలియజేయండి.
- రివ్యూ సమర్పించండి.
- సహకారుడికి సందేహాలు ఉంటే చర్చను గమనించి సహాయం చేయండి.
- అవసరమైన మార్పులు పూర్తయిన తర్వాత PRను
masterలో merge చేయండి.
ఎల్లప్పుడూ ఈ విషయాన్ని నిర్ధారించండి:
- మార్పులు ప్రాజెక్ట్ను దెబ్బతీయకూడదు
- లైవ్ పేజీ సక్రమంగా పనిచేస్తుండాలి
Merge చేసే ముందు స్థానికంగా పరీక్షించడం ఉత్తమ పద్ధతి.
ఏదైనా అనుమానాస్పద మార్పు ఉంటే, దాన్ని merge చేయకండి.
లంబిత PRలు తక్కువగా ఉంటే, పూర్తి రివ్యూ ప్రక్రియను నేరుగా GitHub లో చేయవచ్చు.
అయితే, ఎక్కువ PRలు పెండింగ్లో ఉన్నప్పుడు merge conflictల అవకాశాలు పెరుగుతాయి.
Diffలు చూడటానికి మరియు conflictలు పరిష్కరించడానికి మీకు పరిచయమైన ఏ టూల్ అయినా ఉపయోగించవచ్చు.
ఒక సిఫారసు చేయబడిన టూల్:
ఇది ఒక విజువల్ ఇంటర్ఫేస్ అందిస్తుంది మరియు అనేక PRలను నిర్వహించడంలో సహాయపడుతుంది.
GitKraken ను డౌన్లోడ్ చేసి, ప్రాజెక్ట్ను clone చేసి, మీ కోడ్ ఎడిటర్తో కలిపి ఉపయోగించండి.
ఇందులో ఉన్న merge conflict టూల్స్ ద్వారా మీరు సమర్థవంతంగా రివ్యూ, పరిష్కారం మరియు merge చేయగలరు.
ప్రాజెక్ట్లో Prettier ఉపయోగించబడుతుంది, తద్వారా కోడ్ ఫార్మాటింగ్ ఒకే విధంగా ఉంటుంది.
HTML ఫైల్ అసమంజసంగా కనిపిస్తే, ప్రాజెక్ట్ రూట్లో ఈ కమాండ్ నడపండి:
npx prettier --write index.html