Sign inGet started
← Back to all guides

How to add comments to a Jupyter notebook

By Nick Barth

Updated on March 6, 2024

Data science is a team sport. The conversation needs to include different stakeholders with different views. The usual people are other data scientists and business stakeholders.

If you’re in a Jupyter notebook, getting feedback from these people is possible but involves degrees of separation from the original notebook. It’d be much better to collaborate in the notebook itself, which you can do with other tools.

Getting feedback and comments in a Jupyter notebook

Comments from data scientists involve a code review workflow on platforms like GitHub. This is problematic for the same reasons that using Git for Jupyter notebooks is. It’s a workflow designed for software engineers.

Comments from business stakeholders involve taking parts of the notebook out and putting it into a convenient format, like screenshots in a presentation or an Excel export. This is removed from the notebook itself. When you make changes based on those inevitable comments, you’ll need to go through making sure your screenshots and exports are up to date.

Using a notebook with comments built-in

You can avoid all of these problems by using a Jupyter-compatible notebook tool such as Deepnote that lets you make comments directly inside the notebook. As they’re close to the code, data scientists can leave comments easily. As the user interface is approachable for everyone, business stakeholders can leave comments as well.

Nick Barth

Product Engineer

Nick has been interested in data science ever since he recorded all his poops in spreadsheet, and found that on average, he pooped 1.41 times per day. When he isn't coding, or writing content, he spends his time enjoying various pursuits leisure.

Follow Nick on LinkedIn and GitHub

That’s it, time to try Deepnote

Get started – it’s free
Book a demo

Footer

Solutions

  • Notebook
  • Data apps
  • Machine learning
  • Data teams

Product

Company

Comparisons

Resources

  • Privacy
  • Terms

© Deepnote