~/Blog

Brandon Rozek

Photo of Brandon Rozek

PhD Student @ RPI studying Automated Reasoning in AI and Linux Enthusiast.

Live Documentation

Published on

Updated on

Warning: This post has not been modified for over 2 years. For technical posts, make sure that it is still relevant.

This blog post is mostly for one of my teams in which I use Jupyter Notebooks for documentation. Perhaps after reading this post, you the reader can understand why it might be beneficial to use Jupyter Notebooks as a form of documentation.

Why?

So why Jupyter Notebooks?

  • Follows the literate programming approach. You can write text explaining a feature and then immediately show code and it’s result.
  • It’s modifiable. If your user wants to play around with the documentation, the environment is set up for them to do so.
  • It’s exportable. Let’s say another user doesn’t want to bother setting it up. Well it’s super simple to just export the notebook as a PDF and send that to them instead.

Setting up

Jupyter Notebooks are part of the Project Jupyter suite of products. You can install it via a pip package, but it is more commonly installed via the Anaconda Distribution

Once you have that installed, run jupyter lab in the directory that you wish to execute code from. You might need to be in the bash shell for this to work since the installer modifies those environmental variables.

Reply via Email Buy me a Coffee
Was this useful? Feel free to share: Hacker News Reddit Twitter

Published a response to this? :