Noteable

Starting a new notebook in Noteable

1. Make sure you are using the Firefox or Google Chrome browser, but not Microsoft Edge
2. Go to the FDS Learn page and click on View course & institution tools under Books & Tools. It is located in the sidebar and looks like this:
   
3. Click on the Noteable link, which looks like this:
   
   Noteable will automatically open in a new tab. If you try to manually open Noteable in
   a new tab, Noteable will not load.
4. The next screen may say “Loading. . . ”. There may also be a message saying “Your
   browser may have blocked the opening of the new window; try clicking the button below
   to open ‘Noteable’.” If so, click on the button.
5. Once Noteable has loaded, you should see text saying “Please select a personal
   notebook server”. Ensure Standard Python 3 is selected and click Start.
6. You may get a message asking whether you want to reconnect or shut down an existing
   notebook server. You normally do not have to click anything, but if the dashboard
   doesn’t load in a couple of minutes, click “shut down” and start again. You will get this
   message if you already have Noteable open in a separate tab, in which case you can
   click “reconnect” to work in multiple tabs.
7. You should now see the JupyterLab interface. Open a new notebook by clicking on the Python 3 (ipykernel) under Notebook.

Loading a lab notebook using Git

1. From the top menu, select Git→Clone a Repository. A dialogue box entitled Clone a repo should appear.
2. In this dialogue box paste the link for the relevant lab where it says Enter the URI of the remote Git repository and click on Clone. You will find the link in that week's folder in Course Materials, e.g. the link in the Week 1 folder in Course Materials is https://github.com/Inf2-FDS/FDS-S1-01-introduction
3. After a few seconds, you should find a folder called FDS-S1-01-introduction in the sidebar.
4. Click into that folder, and select FDS-S1-01-introduction.ipynb.

Collaborating on a notebook

Noteable also offers the ability to share notebooks which allows you to pair-program on two separate devices at the same time. See the Noteable documentation for how to do this. 

We recommend pair-programming in person where two students can share a lab machine / laptop and take turns to be the driver and navigator.