முதல் பங்களிப்புகள்

நீங்கள் ஏதாவது ஒன்றை முதல் முறை செய்யும் போது அது எப்போதுமே கடினமாக தான் இருக்கும். குறிப்பாக, நீங்கள் குழுவாக சேர்ந்து வேலை செய்யும் போது, தவறு செய்துவிட்டால் அது மிகவும் வருத்தம் அளிக்கக்கூடியதாக இருக்கும். ஆகையால், திறந்த மூல மென்பொருள் (open-source software) பங்களிப்பாளர்களாக எவ்வாறு செயலாற்ற வேண்டும் என்பதையும் அதில் முதல் முறையாக பங்களிப்பு செய்வதை எளிதாக்குவதுமே எங்கள் நோக்கம்.

கட்டுரைகளைப் படிப்பதும், பயிற்சிகளைப் பார்ப்பதும் உதவக்கூடும், ஆனால் நடைமுறைச் சூழலில் செய்முறையாகச் செய்வதை விட சிறந்தது என்ன? இந்த திட்டம் வழிகாட்டுதல்களை வழங்குவதையும், ஆரம்பநிலை பங்களிப்பாளர்களை அவர்களின் முதல் பங்களிப்பை எளிதாக்குவதையும் நோக்கமாகக் கொண்டுள்ளது. உங்கள் முதல் பங்களிப்பை வழங்க விரும்பினால், கீழே உள்ள வழிமுறைகளை பின்பற்றவும்.

command line tool உங்களுக்கு வசதியாக இல்லை என்றால், இங்கே GUI tools ஐ பயன்படுத்தி பயிற்சிகள் உள்ளன.

உங்கள் கணினியில் git இல்லை என்றால், install செய்யவும்.

இந்த repository ஐ fork செய்தல்

இந்த பக்கத்தின் மேலே உள்ள fork பொத்தானைக் சொடுக்குவதன் மூலம் செயல்படுத்தலாம். இது உங்கள் account இல் ஒரு நகலை உருவாக்கும்.

இந்த repository ஐ clone செய்தல்

இப்போது உங்கள் கணினியில் fork செய்யப்பட்ட repository ஐ clone செய்யவும். உங்கள் GitHub கணக்கிற்குச் சென்று, forked செய்யப்பட்ட repository ஐ திறந்து clone பொத்தானைக் சொடுக்கிய பின் copy to clipboard சொடுக்குவதன் மூலம் நிறைவேற்றலாம்.

terminal அல்லது command prompt ஐ திறந்து பின்வரும் git கட்டளையை இயக்கவும்:

git clone "நீங்கள் copy செய்த url"

உதாரணத்திற்கு:

git clone https://github.com/<உங்கள்-பயனர்பெயர்>/first-contributions.git

இங்கு <உங்கள்-பயனர்பெயர்> என்பது GitHub username என்பதாகும். இதன் மூலம் நீங்கள் first-contributions repository இன் பிரதி ஒன்றை உங்கள் GitHub கணக்கில் செயட்படுத்துகிறீர்கள்.

கிளையொன்றை உருவாக்குதல்

repository directory க்கு செல்லவும் (நீங்கள் ஏற்கனவே அங்கு இல்லையென்றால்):

cd first-contributions

இப்போது git checkout கட்டளையைப் பயன்படுத்தி ஒரு கிளையை உருவாக்கவும்:

git checkout -b <உங்கள்-கிளையின்-பெயர்>

உதாரணத்திற்கு:

git checkout -b உங்கள்-கிளையின்-பெயர்

(கிளையின் பெயருக்கு அதில் add சேர்க்க வேண்டிய அவசியமில்லை, ஆனால் இது ஒரு நியாயமான விஷயம், ஏனெனில் இந்த கிளையின் நோக்கம் உங்கள் பெயரை ஒரு பட்டியலில் சேர்ப்பதுதான்.)

தேவையான மாற்றங்களைச் செய்து அந்த மாற்றங்களை commit செய்யுங்கள்

இப்போது text editor அல்லது notepad இல் Contributors.md கோப்பைத் திறந்து, அதில் உங்கள் பெயரைச் சேர்க்கவும். கோப்பின் தொடக்கத்திலோ அல்லது முடிவிலோ இதைச் சேர்க்க வேண்டாம். இடையில் எங்கும் வைக்கவும். இப்போது, கோப்பை சேமிக்கவும்.

நீங்கள் project directory க்கு சென்று git status இயக்கினால், மாற்றங்கள் இருப்பதை நீங்கள் காண்பீர்கள்.

git add கட்டளையைப் பயன்படுத்தி நீங்கள் உருவாக்கிய கிளையில் அந்த மாற்றங்களைச் சேர்க்கவும்:

git add Contributors.md

இப்போது git commit கட்டளையைப் பயன்படுத்தி அந்த மாற்றங்களைச் செய்யுங்கள்:

git commit -m "Add <உங்கள்-பெயர்> to Contributors list"

<உங்கள்-பெயர்> என்ற இடத்தில் உங்கள் பெயரை கொடுங்கள்.

மாற்றங்களை GitHub ற்கு push செய்தல்

git push கட்டளையைப் பயன்படுத்தி உங்கள் மாற்றங்களைத் தள்ளுங்கள்:

git push origin <உங்கள்-கிளையின்-பெயர்>

<உங்கள்-கிளையின்-பெயர்> என்றிருக்கும் இடத்தில் நீங்கள் முன்பு உருவாக்கிய கிளையின் பெயரை உள்ளிடுங்கள்.

push செய்யும் போது ஏதேனும் பிழைகள் ஏற்பட்டால், இங்கே சொடுக்கவும்:

அங்கீகாரப் பிழை

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/'

உங்கள் account இல் ஒரு SSH key உருவாக்குதல் மற்றும் கட்டமைத்தல் பற்றிய GitHub இன் பயிற்சிக்கு செல்லவும்.

உங்கள் மாற்றங்களை மதிப்பாய்வுக்கு சமர்ப்பிக்கவும்

GitHub இல் உள்ள உங்கள் களஞ்சியத்திற்குச் சென்றால், Compare & pull request கோரிக்கை பொத்தானைக் காண்பீர்கள். அந்த பொத்தானை சொடுக்கவும்.

இப்போது இழுக்கும் கோரிக்கையை சமர்ப்பிக்கவும்.

விரைவில் உங்கள் எல்லா மாற்றங்களும் இந்த திட்டத்தின் முதன்மை கிளையில் இணைக்கப்படும். மாற்றங்கள் ஒன்றிணைக்கப்பட்டவுடன் உங்களுக்கு அறிவிப்பு மின்னஞ்சல் கிடைக்கும்.

இங்கிருந்து எங்கு செல்வது?

வாழ்த்துக்கள்! நீங்கள் ஒரு பங்களிப்பாளராக அடிக்கடி சந்திக்கும் fork -> clone -> edit -> PR பணிப்பாய்வை முடித்துவிட்டீர்கள்.

உங்கள் பங்களிப்பைக் கொண்டாடுங்கள் மற்றும் உங்கள் நண்பர்கள் மற்றும் பின்தொடர்பவர்களுடன் web app சென்று பகிர்ந்து கொள்ளுங்கள்.

உங்களுக்கு மேலும் பயிற்சி தேவைப்பட்டால், code contributions என்னும் செயலை சரிபார்க்கலாம்.

இப்போது மற்ற திட்டங்களுக்கு பங்களிப்பதன் மூலம் தொடங்குவோம். நீங்கள் தொடங்கக்கூடிய எளிதான சிக்கல்களுடன் திட்டங்களின் பட்டியலை நாங்கள் தொகுத்துள்ளோம். பாருங்கள் the list of projects in the web app.