Qiskit-ட்டில் பங்களிப்பு¶
Qiskit என்பது குவாண்டம் கம்ப்யூட்டிங்-இல் எவ்வித முன் அனுபவம் இல்லா மக்களுக்கும் கொண்டு சேர்க்க உருவாக்கப்பட்ட ஒரு ஓபென்-சோர்ஸ் ப்ராஜெக்ட் ஆகும். இப்பகுதி நீங்கள் எவ்வாறு qiskit குழு -இன் மூலம் இவ்விலக்கில் சேர முடியும் என்பதை விவரிக்கும்.
துவங்குவதற்கு முன்¶
நீங்கள் Qiskit பங்களிப்பிற்கு புதியவராக இருந்தால், குறியீட்டிற்குள் நுழைவதற்கு முன், பின்வருவனவற்றைச் செய்யுமாறு பரிந்துரைக்கிறோம்:
நடத்தை நெறிமுறை என்பதைப் படிக்கவும்
<decide-what-to-work-on> என்பதில் என்ன வேலை செய்ய வேண்டும் என்பதை முடிவு செய்யுங்கள்
நீங்கள் பங்களிக்க முடிவு செய்துள்ள ரெப்போவுக்கான ரெப்போ-குறிப்பிட்ட Contributing Guidelines ஐப் படிக்கவும்.
Qiskit சமூகத்துடன் உங்களைப் பழக்கப்படுத்திக்கொள்ளுங்கள் (Slack, Stack Exchange, GitHub போன்றவை.)
என்ன வேலை செய்ய வேண்டும் என்பதை முடிவு செய்யுங்கள்¶
உங்களுக்கு எந்த வகையான பங்களிப்பு சரியானது என்று உங்களுக்குத் தெரியாவிட்டால், உங்களுக்கு உதவ பின்வரும் பாய்வு விளக்கப்படத்தைப் பார்க்கவும்:
ஒரு குறிப்பிட்ட ரெப்போவுக்கு பங்களிக்கிறது¶
ஒவ்வொரு கிஸ்கிட் தொகுப்புக்கும் அதன் சொந்த பங்களிப்பு வழிகாட்டுதல்கள் உள்ளன ('CONTRIBUTING.md` கோப்பில் வைக்கப்பட்டுள்ளது) இது அந்த களஞ்சியத்தில் பங்களிப்பது குறித்த குறிப்பிட்ட தகவலை விவரிக்கிறது. ஒவ்வொரு திட்டத்திற்கும் சற்று வித்தியாசமான தேவைகள் மற்றும் செயல்முறைகள் இருக்கக்கூடும் என்பதால், குறிப்பிட்ட ரெப்போவிற்கு உங்கள் பங்களிப்பை வழங்குவதற்கு முன், ரெப்போ-குறிப்பிட்ட பங்களிப்பு வழிகாட்டுதல்களைப் படித்திருப்பதை உறுதிசெய்யவும்.
உங்கள் மேம்பாட்டு சூழலை அமைக்கவும்¶
பைதான் அடிப்படையிலான Qiskit களஞ்சியங்களில் பங்களிக்கத் தொடங்க, நீங்கள் ஒரு பைதான் மெய்நிகர் மேம்பாட்டு சூழலை அமைக்க வேண்டும் மற்றும் பொருத்தமான தொகுப்பை மூலத்திலிருந்து நிறுவ வேண்டும்.
Qiskit-terra க்கு இதை எப்படி செய்வது என்பது பற்றிய விரைவான வழிகாட்டிக்கு Qiskit-ஐ எவ்வாறு நிறுவுவது - பங்களிப்பாளர்கள் YouTube வீடியோவைப் பார்க்கவும்.
வெவ்வேறு Qiskit தொகுப்புகளை எவ்வாறு நிறுவுவது என்பதை மூலத்திலிருந்து install-from-source என்பதில் நீங்கள் அறிந்து கொள்ளலாம்.
பைதான் அல்லாத தொகுப்புகளுக்கு, உங்கள் டெவ் சூழலை அமைப்பது குறித்த குறிப்பிட்ட விவரங்களுக்கு CONTRIBUTING.md கோப்பைப் பார்க்கவும்.
பைதான் மெய்நிகர் மேம்பாட்டு சூழலை அமைக்கவும்¶
கணினி அளவிலான தொகுப்புகளிலிருந்து வளர்ச்சி சூழலைத் தனிமைப்படுத்த Qiskit மேம்பாட்டிற்கு மெய்நிகர் சூழல்கள் பயன்படுத்தப்படுகின்றன. இந்த வழியில், நாம் கவனக்குறைவாக ஒரு குறிப்பிட்ட கணினி உள்ளமைவைச் சார்ந்திருப்பதைத் தவிர்க்கிறோம். டெவலப்பர்களுக்கு, இது பல சூழல்களை பராமரிப்பதை எளிதாக்குகிறது (எ.கா. ஆதரிக்கப்படும் Python பதிப்பிற்கு ஒன்று, Qiskit இன் பழைய பதிப்புகள் போன்றவை).
Qiskit ஆதரிக்கும் அனைத்து பைதான் பதிப்புகளிலும் உள்ளமைக்கப்பட்ட மெய்நிகர் சூழல் தொகுதி venv ஆகியவை அடங்கும்.
venv மூலம் புதிய மெய்நிகர் சூழலை உருவாக்குவதன் மூலம் தொடங்கவும். இதன் விளைவாக வரும் சூழல் அதை உருவாக்கிய பைத்தானின் அதே பதிப்பைப் பயன்படுத்தும் மற்றும் முன்னிருப்பாக நிறுவப்பட்ட கணினி அளவிலான தொகுப்புகளைப் பெறாது. குறிப்பிட்ட கோப்புறை உருவாக்கப்படும் மற்றும் சூழலின் நிறுவலை வைத்திருக்க பயன்படுகிறது. இது எங்கும் வைக்கப்படலாம். மேலும் விவரங்களுக்கு, அதிகாரப்பூர்வ பைதான் ஆவணத்தைப் பார்க்கவும், விர்ச்சுவல் சூழல்களை உருவாக்குதல்.
python3 -m venv ~/.venvs/qiskit-dev
சூழல் கோப்புறையில் உள்ள உங்கள் கணினிக்கான பொருத்தமான செயல்படுத்தல் ஸ்கிரிப்டை செயல்படுத்துவதன் மூலம் சூழல் கோப்புறையில் காணலாம். உதாரணமாக, bash/zshக்கு:
source ~/.venvs/qiskit-dev/bin/activate
உங்கள் கணினியில் அடுத்தடுத்த பிரிவுகளில் நிறுவப்பட்ட கிஸ்கிட் சார்புகளை உறுதிப்படுத்த சுற்றுச்சூழலுக்குள் பிப்பை மேம்படுத்தவும்.
pip install -U pip
Conda பயனர்களுக்கு, ஒரு புதிய சூழலைப் பின்வருமாறு உருவாக்கலாம்.
conda create -y -n QiskitDevenv python=3
conda activate QiskitDevenv
pip install -e .
புல் ரிக்வெஸ்ட் -கள்¶
நாம் நம் பங்களிப்பை ஏற்றுக்கொள்ள GitHub pull requests பயன்படுத்துவோம்.
தேவையற்ற போது புதிதாக ஒரு புல் ரிக்வெஸ்ட் -ஐ உருவாக்குவதற்கு முன்பு, ஒரு புதிய இஸ்சு -வை உருவாக்குவது நீங்கள் சரிபார்க்கும் பிழை அல்லது வேலை பார்க்கும் அம்சத்தைப் பற்றி சமூகத்தில் கலந்துரையாடலைத் தேவைப்படும் ஒரு முக்கியப் படியாகும். நீங்கள் உருவாக்கும் இஸ்சு, நீங்கள் உங்களின் யோசனையைப் பற்றிப் பேசுவதற்கான இடத்தை கொடுக்கிறது மற்றும் அதை உங்கள் செயல்திட்டத்தின் கோடு -உடன் எவ்வாறு ஒன்றிணைத்து செயல்படுத்துவது என்பதையும் கலந்துரையாட வழிவகுக்கிறது. அது மட்டுமல்லாது, நீங்கள் என்ன வேலை செய்கிறீர்கள் என்பதையும் சமூகத்தினரால் அறிய முடியும் மற்றும் உங்களுக்கு ஏதாவது உதவி தேவைப்பட்டால், அந்த இஸ்சு -வை குறிப்பிட்டு உங்கள் குழுவிடமோ அல்லது சமூகத்திடமோ கேட்டுத் தெரிந்து கொள்ளலாம்.
நீங்கள் சில குறியீட்டை எழுதியிருந்தாலும், அதை முடிப்பதற்கு உதவி தேவைப்பட்டால், அதை முடிப்பதற்கு முன், அதைப் பற்றிய ஆரம்பக் கருத்தைப் பெற விரும்பினால், அல்லது அதைச் செயல்படுத்தி முடிப்பதற்கு முன் அதைப் பகிரவும் விவாதிக்கவும் விரும்பினால், நீங்கள் ஒரு வரைவு இழுக்கும் கோரிக்கையைத் திறந்து முன்வைக்கலாம். [WIP] குறிச்சொல்லுடன் தலைப்பு (செயல்பாட்டில் உள்ள பணிக்காக). PR இல் உள்ள குறியீடு அதன் இறுதி நிலையில் இல்லை மற்றும் மாறும் என்பதை மதிப்பாய்வாளர்களுக்கு இது குறிக்கும். அது முடியும் வரை உறுதிமொழியை இணைக்க மாட்டோம் என்பதும் இதன் பொருள். நீங்கள் அல்லது ஒரு மதிப்பாய்வாளர் [WIP] குறிச்சொல்லை நீக்க முடியும், குறியீடு முழுமையாக மதிப்பாய்வு செய்யப்படுவதற்குத் தயாராக இருக்கும் போது.
உங்கள் இழுத்தல் கோரிக்கையை "மதிப்பாய்வுக்குத் தயார்" எனக் குறிக்கும் முன், கீழேயுள்ள PR சரிபார்ப்புப் பட்டியலைப் பின்பற்றியுள்ளீர்கள் என்பதை உறுதிப்படுத்திக் கொள்ளவும். இந்தப் பட்டியலைப் பின்பற்றும் PRகள் மதிப்பாய்வு செய்யப்பட்டு சரியான நேரத்தில் ஒன்றிணைக்கப்படுவதற்கான வாய்ப்புகள் அதிகம்.
** Pull Request Checklist: **¶
நீங்கள் பங்களிக்கும் குறிப்பிட்ட ரெப்போவுக்கான CONTRIBUTING.md கோப்பில் உள்ள தேவைகளைப் பின்பற்றியுள்ளீர்கள்.
அனைத்து CI சரிபார்த்தல்களும் கடந்துவிட்டன (தள்ளுவதற்கு முன் அந்த இடத்திற்குறிய சோதனைகள் மற்றும் லிண்ட் சரிபார்த்தல்களை இயக்கப் பரிந்துரைக்கப்படுகிறது).
அறிமுகப்படுத்தப்பட்ட எந்தவொரு புதிய செயல்பாட்டிற்கும் புதிய சோதனைகள் உள்ளன.
புதிய/மாற்றியமைக்கப்பட்ட செயல்பாட்டிற்கு ஏற்ப ஆவணங்கள் புதுப்பிக்கப்பட்டுள்ளன.
மாற்றம் பயனர் எதிர்கொள்ளும் தாக்கத்தை ஏற்படுத்தினால், வெளியீட்டுக் குறிப்பு சேர்க்கப்பட்டுள்ளது.
மிதமிஞ்சிய கருத்துகள் அல்லது அச்சு அறிக்கைகள் அகற்றப்பட்டன.
அனைத்து பங்களிப்பாளர்களும் பங்களிப்பாளர் உரிம ஒப்பந்தம் இல் கையொப்பமிட்டுள்ளனர்.
PR ஆனது சுருக்கமான மற்றும் விளக்கமளிக்கும் தலைப்பைக் கொண்டுள்ளது (எ.கா.
Fixes Issue1234ஒரு மோசமான தலைப்பு!).PR ஒரு திறந்த சிக்கலைக் குறிப்பிடினால், PR விளக்கத்தில் அந்தச் சிக்கலுடன் PR ஐ இணைக்க
fixes #issue-numberதொடரியல் அடங்கும் (PR இணையும்போது GitHub தானாகவே சிக்கலை மூடுவதற்கு நீங்கள் சரியான சொற்றொடரைப் பயன்படுத்த வேண்டும்)
Code விமர்சனம்¶
குறியீட்டு மதிப்பாய்வு திறந்த நிலையில் செய்யப்படுகிறது மற்றும் யாருக்கும் திறந்திருக்கும். பராமரிப்பவர்களுக்கு மட்டுமே இணைப்பதற்கான அணுகல் இருக்கும்போது, இழுக்கும் கோரிக்கைகள்பற்றிய சமூக கருத்து மிகவும் மதிப்புமிக்கது. குறியீடு அடிப்படையைப் பற்றி அறிய இது ஒரு நல்ல வழிமுறையாகும்.
உங்கள் PRக்கான பதிலளிப்பு நேரங்கள் மாறுபடலாம், மற்ற உள் பொறுப்புகள் காரணமாக, பராமரிப்பாளர் உங்கள் வேலையை மதிப்பாய்வு செய்ய சில வாரங்கள் காத்திருப்பது அசாதாரணமானது அல்ல. உங்கள் PR மதிப்பாய்விற்காக நீங்கள் ஒரு வாரத்திற்கும் மேலாக காத்திருந்தால், உங்கள் வேலையை மதிப்பாய்வு செய்யுமாறு பணிவுடன் நினைவூட்டுவதற்கு, தொடர்புடைய பராமரிப்பாளரை ஒரு கருத்தில் குறியிடவும்.
தயவுசெய்து பொருமைையாயிரு! பராமரிப்பாளர்கள் பல முன்னுரிமைகளில் கவனம் செலுத்த வேண்டும், எனவே உங்கள் பணி மதிப்பாய்வு செய்யப்பட்டு ஒன்றிணைக்க சிறிது நேரம் ஆகலாம். நல்ல நிலையில் இருக்கும் PRகள் (அதாவது ** Pull Request Checklist: ** ஐப் பின்பற்றுவது) பராமரிப்பாளர்களுக்கு எளிதாக மதிப்பாய்வு செய்யக்கூடியது மற்றும் சரியான நேரத்தில் ஒன்றிணைக்கப்படுவதற்கான வாய்ப்புகள் அதிகம். பராமரிப்பாளர்கள் மற்றும் பிற பங்களிப்பாளர்களுடனான உங்கள் தொடர்புகளில் எப்போதும் கனிவாகவும் மரியாதையுடனும் இருப்பதை உறுதிப்படுத்திக் கொள்ளவும், Qiskit நடத்தை நெறிமுறை <https://github.com/Qiskit/qiskit/blob/master/CODE_OF_CONDUCT.md> என்பதைப் படிக்கலாம். __.
பங்களிப்பாளர் உரிம ஒப்பந்தம்¶
நீங்கள் உங்கள் code-ஐ சமர்ப்பிக்கும் முன், அணைத்து பங்களிப்பாளர்களும் contributor license agreement (CLA)-வில் கையெழுத்திட வேண்டும். அவ்வாறு கையெழுத்திடுவதால், நீங்கள் உங்களின் பங்களிப்பின் எழுத்தாளராக சான்றளிக்கப் படுகிறீர்கள் மற்றும் அதை நீங்கள் Apache-2.0 உரிமத்தின் விதிமுறையின் கிழ் இலவசமாக பங்களிக்கிரீர்கள்.
நீங்கள் Qiskit செயல்திட்டத்திற்கு ஒரு புதிய புல் ரிக்வெஸ்ட் மூலம் பங்களிக்கிரீர்கள் என்றால், ஒரு bot உருவாகி, உங்குளின் CLA கையெழுத்திடப் பட்டதா என்பதை சரிபார்க்கும். தேவைப்பட்டால், அந்த bot உங்கள் புல் ரிக்வெஸ்ட்-ல் கருத்து தெரிவிப்பதோடு நீங்கள் ஒப்பந்தத்தில் கையெழுத்திட தொடர்புகளையும் பதிவு செய்யும். individual CLA ஆவணம் விமர்சனத்துக்காக PDF ஆக இருக்கும்.
Note
உங்களின் பங்களிப்பு உங்கள் வேலையின் ஒரு பகுதியாகவோ அல்லது உங்கள் முதலாளிக்கு சொந்தமானதில் ஒரு பகுதியாகவோ இருந்தால், நீங்கள் கட்டாயமாக corporate CLA விலும் சேர்த்து கையெழுத்திட வேண்டும் மற்றும் அதனை எங்களுக்கு இம்மின்னஞ்சல் <qiskit@us.ibm.com> மூலம் தெரிவிக்கவும்.