From c170cf1edf781272863f73b9da8057bcf8f4316c Mon Sep 17 00:00:00 2001 From: Peter Corke Date: Fri, 20 Nov 2026 11:50:23 +1000 Subject: [PATCH] docs: explain the JupyterLite sidebar and that its files are volatile A new last cell of the notebooks index, as in bdsim: where the files live (the browser's IndexedDB), how to create, upload and open one, that they can be lost, and that a notebook already opened does not pick up later updates to the site. Fixes #168 Fixes #173 Co-Authored-By: Claude Sonnet 5.5 --- docs/notebooks/index.ipynb | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/docs/notebooks/index.ipynb b/docs/notebooks/index.ipynb index 374fa094..19cc07c4 100644 --- a/docs/notebooks/index.ipynb +++ b/docs/notebooks/index.ipynb @@ -65,6 +65,24 @@ " Created by Peter Corke | QUT Centre for Robotics\n", "

" ] + }, + { + "cell_type": "markdown", + "id": "7c1e5a92", + "metadata": {}, + "source": [ + "## Working with files\n", + "\n", + "> **The sidebar.** The left-hand **sidebar** lists the local files, which are kept in a virtual file system within the browser (managed via IndexedDB).\n", + ">\n", + "> * To create a new notebook use *File/New/Notebook*\n", + "> * To upload a notebook or data file use the upload icon above the sidebar, or drag and drop files onto the sidebar\n", + "> * To load and open a file from a URL, use *File/Open From URL...*\n", + ">\n", + "> These files are volatile and vulnerable to browser cache clearing or session termination. You can download these files to your local drive by right-clicking a file in the sidebar and selecting *Download*.\n", + ">\n", + "> **Updates.** A notebook that you have already opened stays as it was when you last opened it, and does not pick up later updates to this site. To get the latest version, delete the notebook in the sidebar and reload the page." + ] } ], "metadata": {