Qiskit-ட்டில் பங்களிப்பு¶
Qiskit என்பது குவாண்டம் கம்ப்யூட்டிங்-இல் எவ்வித முன் அனுபவம் இல்லா மக்களுக்கும் கொண்டு சேர்க்க உருவாக்கப்பட்ட ஒரு ஓபென்-சோர்ஸ் ப்ராஜெக்ட் ஆகும். இப்பகுதி நீங்கள் எவ்வாறு qiskit குழு -இன் மூலம் இவ்விலக்கில் சேர முடியும் என்பதை விவரிக்கும்.
துவங்குவதற்கு முன்¶
நீங்கள் Qiskit பங்களிப்பிற்கு புதியவராக இருந்தால், குறியீட்டிற்குள் நுழைவதற்கு முன், பின்வருவனவற்றைச் செய்யுமாறு பரிந்துரைக்கிறோம்:
நடத்தை நெறிமுறை என்பதைப் படிக்கவும்
<decide-what-to-work-on> என்பதில் என்ன வேலை செய்ய வேண்டும் என்பதை முடிவு செய்யுங்கள்
நீங்கள் பங்களிக்க முடிவு செய்துள்ள ரெப்போவுக்கான ரெப்போ-குறிப்பிட்ட Contributing Guidelines ஐப் படிக்கவும்.
Qiskit சமூகத்துடன் உங்களைப் பழக்கப்படுத்திக்கொள்ளுங்கள் (Slack, Stack Exchange, GitHub போன்றவை.)
என்ன வேலை செய்ய வேண்டும் என்பதை முடிவு செய்யுங்கள்¶
உங்களுக்கு எந்த வகையான பங்களிப்பு சரியானது என்று உங்களுக்குத் தெரியாவிட்டால், உங்களுக்கு உதவ பின்வரும் பாய்வு விளக்கப்படத்தைப் பார்க்கவும்:
ஒரு குறிப்பிட்ட ரெப்போவுக்கு பங்களிக்கிறது¶
ஒவ்வொரு கிஸ்கிட் தொகுப்புக்கும் அதன் சொந்த பங்களிப்பு வழிகாட்டுதல்கள் உள்ளன ('CONTRIBUTING.md` கோப்பில் வைக்கப்பட்டுள்ளது) இது அந்த களஞ்சியத்தில் பங்களிப்பது குறித்த குறிப்பிட்ட தகவலை விவரிக்கிறது. ஒவ்வொரு திட்டத்திற்கும் சற்று வித்தியாசமான தேவைகள் மற்றும் செயல்முறைகள் இருக்கக்கூடும் என்பதால், குறிப்பிட்ட ரெப்போவிற்கு உங்கள் பங்களிப்பை வழங்குவதற்கு முன், ரெப்போ-குறிப்பிட்ட பங்களிப்பு வழிகாட்டுதல்களைப் படித்திருப்பதை உறுதிசெய்யவும்.
Set up Your Development Environment¶
To get started contributing to the Python-based Qiskit repos you will need to set up a Python Virtual Development Environment and install the appropriate package from source.
For a quick guide on how to do this for qiskit-terra take a look at the How to Install Qiskit - Contributors YouTube video.
You can learn how to install different Qiskit packages from source in the install-from-source.
For non-python packages you should check the CONTRIBUTING.md file for specific details on setting up your dev environment.
Set up Python Virtual Development Environment¶
கணினி அளவிலான தொகுப்புகளிலிருந்து வளர்ச்சி சூழலைத் தனிமைப்படுத்த Qiskit மேம்பாட்டிற்கு மெய்நிகர் சூழல்கள் பயன்படுத்தப்படுகின்றன. இந்த வழியில், நாம் கவனக்குறைவாக ஒரு குறிப்பிட்ட கணினி உள்ளமைவைச் சார்ந்திருப்பதைத் தவிர்க்கிறோம். டெவலப்பர்களுக்கு, இது பல சூழல்களை பராமரிப்பதை எளிதாக்குகிறது (எ.கா. ஆதரிக்கப்படும் Python பதிப்பிற்கு ஒன்று, Qiskit இன் பழைய பதிப்புகள் போன்றவை).
All Python versions supported by Qiskit include built-in virtual environment module venv.
Start by creating a new virtual environment with venv. The resulting
environment will use the same version of Python that created it and will not inherit installed
system-wide packages by default. The specified folder will be created and is used to hold the environment's
installation. It can be placed anywhere. For more detail, see the official Python documentation,
Creation of virtual environments.
python3 -m venv ~/.venvs/qiskit-dev
Activate the environment by invoking the appropriate activation script for your system, which can be found within the environment folder. For example, for bash/zsh:
source ~/.venvs/qiskit-dev/bin/activate
Upgrade pip within the environment to ensure Qiskit dependencies installed in the subsequent sections can be located for your system.
pip install -U pip
For Conda users, a new environment can be created as follows.
conda create -y -n QiskitDevenv python=3
conda activate QiskitDevenv
pip install -e .
புல் ரிக்வெஸ்ட் -கள்¶
நாம் நம் பங்களிப்பை ஏற்றுக்கொள்ள GitHub pull requests பயன்படுத்துவோம்.
தேவையற்ற போது புதிதாக ஒரு புல் ரிக்வெஸ்ட் -ஐ உருவாக்குவதற்கு முன்பு, ஒரு புதிய இஸ்சு -வை உருவாக்குவது நீங்கள் சரிபார்க்கும் பிழை அல்லது வேலை பார்க்கும் அம்சத்தைப் பற்றி சமூகத்தில் கலந்துரையாடலைத் தேவைப்படும் ஒரு முக்கியப் படியாகும். நீங்கள் உருவாக்கும் இஸ்சு, நீங்கள் உங்களின் யோசனையைப் பற்றிப் பேசுவதற்கான இடத்தை கொடுக்கிறது மற்றும் அதை உங்கள் செயல்திட்டத்தின் கோடு -உடன் எவ்வாறு ஒன்றிணைத்து செயல்படுத்துவது என்பதையும் கலந்துரையாட வழிவகுக்கிறது. அது மட்டுமல்லாது, நீங்கள் என்ன வேலை செய்கிறீர்கள் என்பதையும் சமூகத்தினரால் அறிய முடியும் மற்றும் உங்களுக்கு ஏதாவது உதவி தேவைப்பட்டால், அந்த இஸ்சு -வை குறிப்பிட்டு உங்கள் குழுவிடமோ அல்லது சமூகத்திடமோ கேட்டுத் தெரிந்து கொள்ளலாம்.
If you've written some code but need help finishing it, want to get initial feedback on it prior to finishing it, or want to share it and discuss prior to finishing the implementation, you can open a Draft pull request and prepend the title with the [WIP] tag (for Work In Progress). This will indicate to reviewers that the code in the PR isn't in its final state and will change. It also means that we will not merge the commit until it is finished. You or a reviewer can remove the [WIP] tag when the code is ready to be fully reviewed for merging.
Before marking your Pull Request as "ready for review" make sure you have followed the PR Checklist below. PRs that adhere to this list are more likely to get reviewed and merged in a timely manner.
Pull Request Checklist:¶
You have followed the requirements in the CONTRIBUTING.md file for the specific repo you are contributing to.
All CI checks pass (it's recommended to run tests and lint checks locally before pushing).
New tests have for any new functionality that has been introduced.
The documentation has been updated accordingly for any new/modified functionality.
A release note has been added if the change has a user-facing impact.
Any superfluous comments or print statements have been removed.
All contributors have signed the பங்களிப்பாளர் உரிம ஒப்பந்தம்.
The PR has a concise and explanatory title (e.g.
Fixes Issue1234is a bad title!).If the PR addresses an open issue the PR description includes the
fixes #issue-numbersyntax to link the PR to that issue (you must use the exact phrasing in order for GitHub to automatically close the issue when the PR merges)
Code விமர்சனம்¶
Code review is done in the open and is open to anyone. While only maintainers have access to merge commits, community feedback on pull requests is extremely valuable. It is also a good mechanism to learn about the code base.
Response times may vary for your PR, it is not unusual to wait a few weeks for a maintainer to review your work, due to other internal commitments. If you have been waiting over a week for a review on your PR feel free to tag the relevant maintainer in a comment to politely remind them to review your work.
Please be patient! Maintainers have a number of other priorities to focus on and so it may take some time for your work to get reviewed and merged. PRs that are in a good shape (i.e. following the Pull Request Checklist:) are easier for maintainers to review and more likely to get merged in a timely manner. Please also make sure to always be kind and respectful in your interactions with maintainers and other contributors, you can read the Qiskit Code of Conduct.
பங்களிப்பாளர் உரிம ஒப்பந்தம்¶
நீங்கள் உங்கள் code-ஐ சமர்ப்பிக்கும் முன், அணைத்து பங்களிப்பாளர்களும் contributor license agreement (CLA)-வில் கையெழுத்திட வேண்டும். அவ்வாறு கையெழுத்திடுவதால், நீங்கள் உங்களின் பங்களிப்பின் எழுத்தாளராக சான்றளிக்கப் படுகிறீர்கள் மற்றும் அதை நீங்கள் Apache-2.0 உரிமத்தின் விதிமுறையின் கிழ் இலவசமாக பங்களிக்கிரீர்கள்.
நீங்கள் Qiskit செயல்திட்டத்திற்கு ஒரு புதிய புல் ரிக்வெஸ்ட் மூலம் பங்களிக்கிரீர்கள் என்றால், ஒரு bot உருவாகி, உங்குளின் CLA கையெழுத்திடப் பட்டதா என்பதை சரிபார்க்கும். தேவைப்பட்டால், அந்த bot உங்கள் புல் ரிக்வெஸ்ட்-ல் கருத்து தெரிவிப்பதோடு நீங்கள் ஒப்பந்தத்தில் கையெழுத்திட தொடர்புகளையும் பதிவு செய்யும். individual CLA ஆவணம் விமர்சனத்துக்காக PDF ஆக இருக்கும்.
Note
உங்களின் பங்களிப்பு உங்கள் வேலையின் ஒரு பகுதியாகவோ அல்லது உங்கள் முதலாளிக்கு சொந்தமானதில் ஒரு பகுதியாகவோ இருந்தால், நீங்கள் கட்டாயமாக corporate CLA விலும் சேர்த்து கையெழுத்திட வேண்டும் மற்றும் அதனை எங்களுக்கு இம்மின்னஞ்சல் <qiskit@us.ibm.com> மூலம் தெரிவிக்கவும்.