diff --git a/docs/_quarto.yml b/docs/_quarto.yml index b0f61ffab..dcf2404e1 100644 --- a/docs/_quarto.yml +++ b/docs/_quarto.yml @@ -12,7 +12,7 @@ website: href: https://github.com/berkeley-dsep-infra/datahub left: - text: "Using DataHub" - href: users/services.qmd + href: users/features.qmd - text: "Contributing" href: admins/pre-reqs.qmd - text: "Admin Tasks" diff --git a/docs/users/features.qmd b/docs/users/features.qmd new file mode 100644 index 000000000..8092a5bfc --- /dev/null +++ b/docs/users/features.qmd @@ -0,0 +1,79 @@ +--- +title: Features +--- + +This page lists the various environments, applications, and tools we offer on +DataHub. Not all those listed here are available on all hubs, but we can easily enable them. + +## Programming Languages + +We support the usual suspects - Python, R, and Julia. However, Jupyter and +other applications can support many more. If you would like to use a +different, open-source programming language, contact us. + +## Applications + +Our diverse user population has diverse needs, so we offer many different +user interfaces for instructors to choose from. + +### JupyterLab + +![Do complex layouts with JupyterLab](images/jupyterlab.png) + +[JupyterLab](https://github.com/jupyterlab/jupyterlab) is a more modern and customizable version of the classic Jupyter notebook from the Jupyter project. +Most of our classes use JupyterLab. + + +### Jupyter Notebook (Classic) + +This familiar interface is used for most of our introductory classes. It is document oriented, no-frills, and well known by a lot of people. + +### RStudio + +![RStudio Screenshot](images/rstudio.png) + +We want to provide first class support for teaching with R, which means +providing strong support for [RStudio](https://rstudio.com). This also includes support for running Shiny applications. + +Try RStudio [on DataHub](https://r.datahub.berkeley.edu) with your berkeley.edu account, or [on Binder](https://mybinder.org/v2/gh/rocker-org/binder/master?urlpath=rstudio) without a berkeley.edu account. + +### Remote Desktop + +![Do image processing with qt](images/desktop.png) + +Sometimes, you just need to use something that requires a full desktop +environment to run. Instead of trying to get students to install things +locally, we offer a full fledged Linux Desktop environment they can +access from inside their browser! This is just a different 'UI' on the +same infrastructure as the notebook environment, so they all use the +same libraries and home directories. + +Try remote desktop [on EECS DataHub](https://eecs.datahub.berkeley.edu/hub/user-redirect/desktop) with your berkeley.edu account, or [on Binder](https://mybinder.org/v2/gh/yuvipanda/jupyter-desktop-server/master?urlpath=desktop) without a berkeley.edu account. + +### Visual Studio Code + +![Compile C with vscode](images/vscode.png) + +Sometimes you *just* want an IDE, not a notebook environment. We are experimenting +with a hosted, web version of the popular Visual Studio Code editor, to +see if it would be useful for teaching more traditional CS classes. + +Try VS Code [on EECS DataHub](https://eecs.datahub.berkeley.edu/hub/user-redirect/vscode/) with your berkeley.edu account, or [on Binder](https://mybinder.org/v2/gh/betatim/vscode-binder/master?urlpath=lab) without a berkeley.edu account. + +### Other Web Applications + +We can make many web based applications work on a hub. Contact us and we'll see what we can do! + +### Postgresql + +Some of our classes require using real databases to teach. We +now experimentally offer a [postgresql](https://www.postgresql.org/) +server for each user on the [data100 hub](https://data100.datahub.berkeley.edu). + +The data does not persist right now, but we can turn that on whenever +needed. + +## More? + +We want to find solution to your interesting problems, so please bring us +your interesting problems. 😁 diff --git a/docs/users/services.qmd b/docs/users/services.qmd deleted file mode 100644 index b7348e558..000000000 --- a/docs/users/services.qmd +++ /dev/null @@ -1,98 +0,0 @@ ---- -title: Services Offered ---- - -This page lists the various services we offer as part of DataHub. Not all -these will be available on all hubs, but we can easily enable them as -you wish. - -## User Interfaces - -Our diverse user population has diverse needs, so we offer many different -user interfaces for instructors to choose from. - -### Jupyter Notebook (Classic) - -What many people mean when they say 'Jupyter', this familiar interface -is used by default for most of our introductory classes. Document oriented, -no-frills, and well known by a lot of people. - -### RStudio - -![RStudio Screenshot](images/rstudio.png) - -We want to provide first class support for teaching with R, which means -providing strong support for [RStudio](https://rstudio.com). This includes Shiny support. - -Try without berkeley.edu account: [![Launch binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/rocker-org/binder/master?urlpath=rstudio) - -Try with berkeley.edu account: [R DataHub](https://r.datahub.berkeley.edu) - -### JupyterLab - -![Do complex layouts with JupyterLab](images/jupyterlab.png) - -[JupyterLab](https://github.com/jupyterlab/jupyterlab) is a more modern version of the classic Jupyter notebook from -the Jupyter project. It is more customizable and better supports some advanced -use cases. Many of our more advanced classes use this, and we might help -all classes move to this once there is a [simpler document oriented mode available](https://github.com/jupyterlab/jupyterlab/issues/8292) - - -### Linux Desktop (Experimental) - -![Do image processing with qt](images/desktop.png) - -Sometimes, you just need to use something that requires a full desktop -environment to run. Instead of trying to get students to install things -locally, we offer a full fledged Linux Desktop environment they can -access from inside their browser! This is just a different 'UI' on the -same infrastructure as the notebook environment, so they all use the -same libraries and home directories. - -Try without Berkeley.edu account: [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/yuvipanda/jupyter-desktop-server/master?urlpath=desktop) - -Try with Berkeley.edu account: [EECS DataHub](https://eecs.datahub.berkeley.edu/hub/user-redirect/desktop) - -### Visual Studio Code (Experimental) - -![Compile C with vscode](images/vscode.png) - -Sometimes you *just* want an IDE, not a notebook environment. We are experimenting -with a hosted, web version of the popular Visual Studio Code editor, to -see if it would be useful for teaching more traditional CS classes. - -Try without Berkeley.edu account: [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/betatim/vscode-binder/master?urlpath=lab) - -Try with Berkeley.edu account: [EECS DataHub](https://eecs.datahub.berkeley.edu/hub/user-redirect/vscode/) - -### More? - -If you have a web based environment, we can almost certainly make it run under -a hub. Contact us and we'll see what we can do :) - -## Services - -Sometimes you need something custom to get your class going. Very -very interesting things can happen here, so we're always looking -for new services to add. - -### Postgresql - -Some of our classes require using real databases to teach. We -now experimentally offer a [postgresql](https://www.postgresql.org/) -server for each user on the [data100 hub](https://data100.datahub.berkeley.edu). - -The data does not persist right now, but we can turn that on whenever -needed. - -## Programming languages - -We support the usual suspects - Python, R & Julia. However, there are no limits -to what languages we can actually support, so if you are planning on using -a different (open source) programming language, contact us and we'll set you -up. - -## More? - -We want to find solution to your interesting problems, so please bring us -your interesting problems 😁