ucsf-wynton / wynton-website-hpc

The Official Wynton HPC User Website
https://wynton.ucsf.edu/hpc/
2 stars 14 forks source link

Jupyter Notebook Instructions #113

Open ellestad opened 1 year ago

ellestad commented 1 year ago

There are two pages with differing instructions on how to run Jupyter Notebooks on Wynton.

One advises pip and one advises conda.

https://wynton.ucsf.edu/hpc/howto/jupyter.html

-and-

https://wynton.ucsf.edu/hpc/howto/conda.html

Should the pages be combined?

HenrikBengtsson commented 1 year ago

There are two pages with differing instructions on how to run Jupyter Notebooks on Wynton.

I agree this can be confusing.

https://wynton.ucsf.edu/hpc/howto/jupyter.html

This page intends to explains how to launch a personal Jupyter instance and how to access that from remote.

We could remove the pip instructions(*) and only give the Conda instruction and add "See the how-to 'Work with Conda' page for more details.

(*) Wasn't there some email some weeks ago saying one can no longer install Jupyter via pip?

https://wynton.ucsf.edu/hpc/howto/conda.html

On this page we're explaining how to use Conda. This page uses Jupyter just as an example on how to install a software tools via Conda. We could use another software tool here to remove this confusion.

Should the pages be combined?

I don't think so. They have different purposes.

ellestad commented 1 year ago

Plus, we have jhub and ic-app for running jupyter notebooks without the instructions included in either of these pages.

HenrikBengtsson commented 1 year ago

Jupyter Hub, is documented at https://wynton.ucsf.edu/hpc/howto/jupyterhub.html.

I don't think(*) we should include lab-specific (here IC) instructions on the Wynton HPC website; although it's maintained by the Wynton Team, AFAIU it's separate from the Wynton HPC, or? Also, I think they have their own wiki somewhere.

(*) == I'm quite reluctant to go down that path.