Repository navigation
Add community tutorial contribution guidelines - #5813
Draft
Henry Zou (henryzou50) wants to merge 5 commits into
Draft
Henry Zou (henryzou50) wants to merge 5 commits into
Henry Zou (henryzou50) wants to merge 5 commits into
Conversation
Add a "Contribute a tutorial" page with Foundational and Applied requirements, open topics, and problem classes, plus a Stage 1 tutorial proposal issue template. Link the page from the tutorials index and table of contents, and add owners in qiskit_bot.yaml.
Contributor
|
One or more of the following people are relevant to this code:
|
Put Foundational before Applied throughout, merge duplication rules, add a dependency rule, apply the classical baseline to all Applied tutorials, and limit each problem class to one community tutorial per method family. Merge foundational problems, open topics, and problem classes into one section by domain, give each open QIS topic its own teaching problem, and show QOBLIB as a table.
Replace the three requirement sections with a short list for all tutorials and one table comparing Foundational and Applied. Replace the ecosystem dependency rule with an explicit list of approved quantum packages, and show open topic and problem class counts in the summary table.
Show the existing tutorials in each problem class so gaps are easy to see, and stop calling the classes drafts. Add every quantum package that current tutorials use to the approved list, let contributors request new packages in their proposal, and allow Qiskit Functions in any tutorial.
…M Quantum team Steer community contributions in those domains to the problem classes, and say so in the summary table, the out-of-scope list, each domain section, and the proposal form.
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Add community tutorial contribution guidelines
Draft for preview, not final policy. Adds a "Contribute a tutorial" page and a proposal issue template, revised from the "Contribution Requirement Draft" with separate Foundational and Applied requirements and a proposed approach for quantum information science (QIS).
Preview: https://qiskit.github.io/documentation/pr-NUMBER/docs/tutorials/contribute
Changes
docs/tutorials/contribute.mdx: new page covering.github/ISSUE_TEMPLATE/tutorial-proposal.yaml: Stage 1 proposal formdocs/tutorials/_toc.jsonanddocs/tutorials/index.mdx: link the new pageqiskit_bot.yaml: owners for the new pageOpen questions for review
Quantum information science (QIS). The page sets these rules:
Opening every QIS topic could invite a flood of textbook-style tutorials, while closing QIS to the community would leave real gaps unfilled.
Do these rules look good?
The page also lists four potential open Foundational topics for QIS. Any feedback on these?
Applied circuit floor: at least 50 qubits and two-qubit depth 50. Are we good with this requirement?
The page overall. Any general feedback on the "Contribute a tutorial" page? Preview: https://qiskit.github.io/documentation/pr-5813/docs/tutorials/contribute
Should the published page stay more general, with most of the details moved to a separate
contribute.mdthat lives only in this repository?The Hamiltonian simulation and QML problem classes are our own drafts, and may change depending the working groups.
Generative AI disclosure
Drafted with help from Claude Code: page text, issue template, and this description.