Finalizing the notebook apis

[mjbvz]

Issue for tracking finalization (or deprecation) of the various notebook API proposals

Key

⬆️ — Waiting for extensions (upstream)

Tasks

• ⬆️ Removing the notebookDeprecated proposal  #146831
• Remove the notebookContentProvider API proposal #147248
• Migrate to new notebook workspace edit api #149181
• Finalize "simpleUI" debug option #147264
• Finalize the notebook workspace edit API #155245
• Remove the notebookEditorDecorationType api proposal #146838
• Finalize notebookEditor API proposal  #149271
• Removing the textDocumentNotebook API proposal #147414
• Removing the notebook concat text document API proposal  #146781

[mjbvz]

At this point, we've finalized or removed the core notebook APIs. This work has included finalizing proposals for editing and notebook editors, as well as removing all the main proposals that saddled us with significant technical debt

The remaining api proposals are as follows:

• notebookCellExecutionState — This is an advanced API but it also needs more thought as the current proposal has known gaps. With the limited number of use cases we know of, we are not sure finalizing it is worth it.

• notebookControllerAffinityHidden — New API. @IanMatthewHuff Can you please determine if this should be finalized?

• notebookControllerKind — Finalize or remove the notebookControllerKind API Proposal #168535 Small. Unclear if others beside Jupyter need this. Will follow up in linked issue

• notebookDeprecated — Removing the notebookDeprecated proposal  #146831. Minor seeming but kind of annoying to get right. We are tracking this in the linked issue

• notebookKernelSource — New api. @rebornix can you please determine if this API should be finalized

• notebookLiveShare — This will likely be a proposal forever. LiveShare's use case is pretty unique and we don't think other extensions should use this API. It would be nice if we could move LiveShare off of this proposal but we don't know how to do this. The proposal is also not adding much debt to our code

• notebookMessaging — The proposal name is not accurate since most parts of notebook messaging have already been finalized. For the remaining parts, NotebookRendererScript may be replaced by Add static preloads notebook contribution  #163511. It's not clear if notebook controller messaging is needed at all

• notebookMime — NotebookCellData.mime #126280. Will follow up in linked issue

As I believe the original goal of this issue has largely been achieved, I'm going to close this issue. I will following up on the linked issues