Versioning Notebooks

Curvenote provides versioning for your notebooks and their individual cells. When you add a notebook to Curvenote the version numbering for the notebook as a whole begins at one (the cells are also versioned individually as blocks, learn more Blocks & Cells). You and your collaborators can then make changes and save new versions of your notebook. You can preview and use previous versions on Curvenote.

Curvenote¶

You can access a copy of your notebook directly on Curvenote, which will always display the latest saved version. This link will open the saved version you were using in Jupyter, in Curvenote. On Curvenote you can then edit and save new versions or preview the previous versions of your notebook.

Save New Version¶

To make changes to your notebook on Curvenote, requires you to be in Draft Mode, which is indicated by the yellow ✏️ and version number to the right of the notebook title. You may only edit the most recent saved version of your notebook on Curvenote. Curvenote cannot currently run code cells. You can edit Markdown cells on Curvenote, and any new blocks added will be consider Markdown cells when they are opened in Jupyter. Learn more about editing your notebooks in Curvenote ➡️ Curvenote+Jupyter

To save a new version of your notebook on Curvenote:

• Click SAVE VERSION in the app bar (left).
  • Saving a new version of your notebook will save a new version of any blocks/cells within your notebook that were also in Draft Mode and had changes.
• You will be redirected out of Draft Mode, and into a view of your newly saved version.

Preview Previous Versions¶

In Curvenote you can preview previous versions of your notebook, but you are not able to select and use previous versions of your entire notebook, as you were in Jupyter. To view previous versions of your notebook:

• You must be in View Mode.
  • If you are in Draft Mode you must either click STOP EDITING or SAVE VERSION to exit.
• Expand the Block Details Panel. ◀️
  • The previous versions are listed by number, with their save date and time included.
• Click on the Version # you wish to preview.

Versioning with Collaborators¶

When working with others on a notebook, it is possible that multiple people are editing and saving versions at the same time. If you are in Draft Mode when someone else saves a version of the notebook, you will be warned that you are now editing a stale draft and should discard the draft. To discard a stale draft:

• A warning will appear at the top of the Editor which reads:
  • $\bf\textcircled{!}$editing stale draft on v#$\bf\textcircled{\times}$.
  • The notebook version number and draft mode icon ✏️ will change from yellow to red.
  • If you hover the warning, it reads:
    • The draft is stale, you should discard it before continuing. To discard, press the ‘×’ icon here. If in doubt contact support.
• Click the $\bf\textcircled{\times}$.
• If you are certain that you want to delete the draft, click DELETE in the pop-up window.
• The draft will be discarded and the page should automatically reload.
  • You can manually reload the page by refreshing or clicking RELOAD in the pop-up window.
• To continue editing your notebook you will need to reenter Draft Mode.