Skip to content

Docathon: Module level docs for Pulse#3849

Merged
mergify[bot] merged 5 commits into
Qiskit:masterfrom
lcapelluto:docs/pulse-module-high-level-documentation
Feb 18, 2020
Merged

Docathon: Module level docs for Pulse#3849
mergify[bot] merged 5 commits into
Qiskit:masterfrom
lcapelluto:docs/pulse-module-high-level-documentation

Conversation

@lcapelluto
Copy link
Copy Markdown
Contributor

@lcapelluto lcapelluto commented Feb 14, 2020

Summary

Update the pulse module init file for documentation. This includes adding autosummary references to important parts of the module that were previously unreachable, and providing introductory summaries where appropriate

This also closes #3406.

Details and comments

  • One bug that @SooluThomas is helping me with: can't seem to link to the commands module! (made an issue)

Also: I will wait on #3838 to merge first, since I anticipate merge conflicts

@lcapelluto lcapelluto added the documentation Something is not clear or an error documentation label Feb 14, 2020
…ding autosummary references to important parts of the module that were previously unreachable, removing references to pieces that are mostly internal usage, and providing introductary summaries where appropriate
@lcapelluto lcapelluto force-pushed the docs/pulse-module-high-level-documentation branch from 6ca01aa to 83f4772 Compare February 14, 2020 21:30
Copy link
Copy Markdown
Contributor

@DanPuzzuoli DanPuzzuoli left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These descriptions are really well written.

I added two text editing comments, and two comments for overzealous application of class linking.

Aside from these it looks great.

Comment thread qiskit/pulse/__init__.py Outdated
Comment thread qiskit/pulse/__init__.py Outdated
Comment thread qiskit/pulse/__init__.py Outdated
Comment thread qiskit/pulse/__init__.py Outdated
lcapelluto and others added 3 commits February 18, 2020 10:17
Helpful feedback from Dan, including more API cross referencing 🎉

Co-Authored-By: Daniel Puzzuoli <dan.puzzuoli@gmail.com>
@lcapelluto
Copy link
Copy Markdown
Contributor Author

Here is the follow up bug report: #3859

@mergify mergify Bot merged commit 19d149a into Qiskit:master Feb 18, 2020
faisaldebouni pushed a commit to faisaldebouni/qiskit-terra that referenced this pull request Aug 5, 2020
* Update the pulse module init file for documentation. This includes adding autosummary references to important parts of the module that were previously unreachable, removing references to pieces that are mostly internal usage, and providing introductary summaries where appropriate

* Apply suggestions from code review

Helpful feedback from Dan, including more API cross referencing 🎉

Co-Authored-By: Daniel Puzzuoli <dan.puzzuoli@gmail.com>

* Small fixups

* Another attempt to make  linking work

Co-authored-by: Daniel Puzzuoli <dan.puzzuoli@gmail.com>
Co-authored-by: mergify[bot] <37929162+mergify[bot]@users.noreply.github.com>
@1ucian0 1ucian0 added the mod: pulse Related to the Pulse module label Jan 15, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Something is not clear or an error documentation mod: pulse Related to the Pulse module

Projects

None yet

Development

Successfully merging this pull request may close these issues.

qiskit.pulse module and underlying functionality needs documentation.

3 participants