documentation icon indicating copy to clipboard operation
documentation copied to clipboard

Rewrite files with code blocks to Jupyter notebooks

Open Eric-Arellano opened this issue 2 years ago • 2 comments
trafficstars

Jupyter notebooks have a big advantage over MDX: we can test the code still works, and generate images with the newest code. See https://github.com/Qiskit/documentation/issues/78.

Crucially, they still allow us to use MDX components in their markdown - so we lose little converting from MDX to Jupyter, other than that it's a more complex file format.

@lerongil pointed out in https://github.com/Qiskit/documentation/issues/477 that there is an additional benefit of converting to notebooks: it makes our UX more consistent and useful when we have code blocks.

Eric-Arellano avatar Oct 13 '23 20:10 Eric-Arellano

@kevinsung Is this a good place to make a list of any .mdx files you won't be converting to .ipynb? If there are any that will stay in .mdx and also need fresh codeblock output to match the 1.0 styling, I can do that in #833 -- and if not, I'll close that issue.

abbycross avatar Mar 18 '24 20:03 abbycross

@abbycross I marked this issue as "on hold" for now since @javabster and I decided to wait until https://github.com/Qiskit/documentation/issues/524 is finished before doing this. This issue will require a fair amount of coordination so I'll propose a more detailed plan later.

kevinsung avatar Mar 19 '24 13:03 kevinsung

Closing in favor of https://github.com/Qiskit/documentation/issues/2094.

Eric-Arellano avatar Oct 07 '24 18:10 Eric-Arellano