Visitar URL original
ecosystem/CONTRIBUTING.md at main · Qiskit/ecosystem · GitHub
Skip to content

Latest commit

 

History

History
69 lines (59 loc) · 2.08 KB

CONTRIBUTING.md

File metadata and controls

69 lines (59 loc) · 2.08 KB

Contributing

Joining the Ecosystem

To join ecosystem you need to create submission issue and fill in all required details. That's it!

Installation and environment setup

  1. Create new environment:
conda create --name ecosystem python=3.13
  1. Activate the environment:
conda activate ecosystem
  1. Install dependencies:
pip install -r requirements.txt
pip install -r requirements-dev.txt

Performing style checks

  • Run for style checks tox -elint
  • Run for tests tox -epy39
  • Run coverage tox -ecoverage
  • Run black tox -eblack
  • To Fix the black violation black <PATH_FILE_YOU_WANT_TO_FIX>

Create a preview of the website

  1. Build the website: tox -ewebsite
  2. Go to the website/ folder in the root of your project and open up index.html in a browser

Live preview with properdocs serve

For a faster loop while editing the docs you can run ProperDocs (the drop-in continuation of MkDocs 1.x that builds this site) directly, but first install the package and generate the docs assets:

  1. Install the ecosystem package (needed by the gen-files plugin):
pip install -e .
  1. Generate the files in docs/assets/:
python manager.py members update_docs_assets
  1. Serve the docs with live reload:
properdocs serve

The fragments in docs/assets/ (the tables injected into classifications.md, summary.md, checkups.md, etc. by the table-reader plugin) are generated and not tracked in git. Step 2 is what tox -ewebsite does for you, so if you skip it properdocs serve fails with an error like [table-reader-plugin]: Cannot find table file 'docs/assets/unmaintained.md'. Re-run it whenever you change member data under resources/.

Guidance on git

Please follow this link if this is your first time contributing to open source and/or you would like some guidance on how to create and/or merge pull requests.

Dev contributions

Internals overview