Welcome and thank you for contributing to the Qiskit Code Assistant!
If you are thinking to contribute to the Qiskit Code Assistant, you agree to abide by our code of conduct which we strongly recommend you read before continuing.
There are many ways of contributing from opening an issue to preparing a patch to updating documentation. Continue reading the contribution guidelines for opening new issues and submitting pull requests.
Issues can be opened from https://github.com/Qiskit/qiskit-code-assistant-vscode/issues to report failures and misfunctions. Please do provide steps to reproduce and also expected behaviour.
Feel free to view the issues in the repository to decide what to work on.
The very first step to working on an issue is assigning yourself the issue. This gives all contributors the visibility into who is working on what.
Before you start working on an issue you will need to make sure you have the code cloned or forked. And you should be able to run and test the extension locally.
Note: You will need Visual Studio Code and Node.js to contribute and work on the extension.
# Clone the repo to your local environment
# Change directory to the qiskit-code-assistant-vscode directory
# Install extension dependencies
npm ci
# Open the qiskit-code-assistant-vscode directory in Visual Studio Code
code .
You can update, launch, and debug the extension from source within your Visual Studio Code
- Go into the Run and Debug tab in Visual Studio Code
- Select Launch Extension from the drop down
- Press
F5
or click the Start Debugging button (i.e., the green triangle)
With the extension running from source you can use many of the Visual Studio Code Developer commands to debug and troubleshoot
- Press
Cmd/Ctrl+Shift+P
to open the command palette - Type
developer
to see the Developer commands - Select the desired commands (e.g., Toggle Developer Tools, Reload Window, etc.)
You can package the extension into a VSIX file and install it into your Visual Studio Code
# From a Terminal go to the qiskit-code-assistant-vscode directory
# Generate the extension's VSIX file
npm run vsce:package
- Go into the Extensions tab in Visual Studio Code
- Click the ... (i.e., More Actions) button
- Click Install from VSIX...
- Browse and select the VSIX file that was generated
- Restart Visual Code Studio
With the extension running from installed VSIX you can run and test the extension as users would be running it.
If the extension was launched from the Run and Debug, close the Visual Studio Code window that was opened or click the Stop (i.e., the red square) button.
If running using the VSIX file
- Go into the Extensions tab in Visual Studio Code
- Select the Qiskit Code Assistant extension under the INSTALLED section
- Click Uninstall
Also, delete the VSIX file that was generated.
When you are going to start working on an issue, make sure you are in your main
branch and that it is up to date then create a new branch with a meaningful name.
When committing your changes do try to use descritive titles and informative summary notes.
When you think your work is done, create a pull request against the main
branch. In the pull request, provide a description and link with the issue that is being solved.
Once you have sent a pull request, the code contributors get notified, and there will be a code review. The repository also contains some automated checks for pull requests . For a pull request to be ready for merging it needs to pass automatic checks and have, at least, one accepted review.
Thank you for reading until the end of the document! Abiding by these guidelines you express your willingness in collaborating and contributing to the project in a healthy way. Thanks for that too!