Document how to handle drives when creating new files

[jtpio]

Follow-up to #15291

As discussed in #15291 (comment), there should be some documentation to show how to make use of drives when creating new files.

This is also related to jupyterlab/extension-examples#215

[westurner]

• Where does it display which drive(s) are open?

[westurner]

• Should there be a configuration screen per drive, is that up to plugins to do?

[westurner]

documentation to show how to make use of drives when creating new files.

Create a new file workflow(s) (that i just wrote up the other day:)

A. File > New > {Notebook, Text File,}
B. Launcher tab > Notebook card
C. File Browser > right click > New Notebook
D. Command Palette (Ctrl-Shift-C) > New Notebook (or just "new n") > <Enter>

All of these will implicitly create a notebook in the (primary or default or only?) drive.

Where does it display which drive(s) are open?

Possible UI solutions for drive selector:

• Sidebar > File Browser sidebar tab above the filter field
• Sidebar > "Running Terminals and Kernels" tab; before or after "Language Servers"
  • Clicking on the terminal icon in the statusbar already opens the "Running Terminals and Kernels" tab
• Statusbar
• {Menu > Settings, Command Palette, Ctrl-,} > Settings Editor > _

Code for this:

• https://github.com/jupyterlab/jupyterlab/blob/main/packages/filebrowser-extension/src/index.ts
• https://github.com/jupyterlab/jupyterlab/tree/main/packages/running-extension/src
• https://github.com/jupyterlab/jupyterlab/blob/main/packages/apputils-extension/src/statusbarplugin.ts
• https://github.com/jupyterlab/jupyterlab/blob/main/packages/statusbar/src/statusbar.ts

Standard things for an integration tests demo app and each plugin to test:

• Drive settings
  • API Keys
  • Login / OAuth, OIDC
  • Logout
    • "If you logout, your files will or will not be lost if they were not yet synchronized to the remote drive"
• Clicking on the terminal icon in the statusbar already opens the "Running Terminals and Kernels" tab
• Drag and Drop from the File Browser to the notebook and other plugins
  • https://discourse.jupyter.org/t/implementing-drag-and-drop-between-file-browser-and-custom-widget-extension/24545/3

[westurner]

Collaborative Drives should also be selectable from the one Drive(s) Selector widget:

• Allow using the collaboration drive with the default JupyterLab file browser jupyter-collaboration#112
  • IDefaultFileBrowser
    • Does there need to be an additional IInterface to support new UI for "IDriveAdapter" (?)?
  • Support JupyterLab>=4.0 jupyterlite/jupyterlab-webrtc-docprovider#16 (comment)

[westurner]

Maybe

• ENH,UI: add a dropdown multiselect widget that supports (icon, text, settings icon) for the available drive items
  • I guess above File Browser, if that gets replaced when a different IDefaultFileBrowser is open?
  • https://github.com/jupyterlab/jupyterlab/blob/main/packages/filebrowser-extension/src/index.ts

[westurner]

• ?,UI: If there can be multiple drives attached / mounted / configured, which is the primary?
• Can there be multiple instances of the same drive attached (each with different configuration)?