Revise sharing notebooks section for clarity

Updated the section on sharing dynamic notebooks via Binder, including a new exercise format and additional instructions for both Jupyter and R Markdown users.

Author: gregordecristoforo

content/notebooks/sharing.md

@@ -54,24 +54,77 @@ faster access to cloud resources:
 - [Deepnote](https://deepnote.com/) allows real-time collaboration
 
 
-## Sharing dynamic notebooks using [Binder](https://mybinder.org/)
-
-::::{challenge} Exercise/demo: Making your notebooks reproducible by anyone (15 min)
-Instructor demonstrates this:
-- First we look at the statically rendered version of the [example
-  notebook](https://github.com/workshop-material/classification-task/blob/main/example.ipynb)
-  on GitHub and also [nbviewer](https://nbviewer.jupyter.org/).
-- Visit [https://mybinder.org](https://mybinder.org):
-  :::{figure} binder.jpg
-  :alt: Screenshot from mybinder.org user interface
-  :::
-- Check that your notebook repository now has a "launch binder"
-  badge in your `README.md` file on GitHub.
-- Try clicking the button and see how your repository is launched
-  on Binder (can take a minute or two). Your notebooks can now be
-  explored and executed in the cloud.
-- Enjoy being fully reproducible!
-::::
+## Sharing dynamic notebooks on [Binder](https://mybinder.org)
+
+`````{exercise} Exercise (20 min): Making your notebooks reproducible by anyone via Binder
+  - Create a new GitHub repository and **click on "Add a README file"**: <https://github.com/new>
+
+  - This exercise can be done entirely through the GitHub web interface (but
+    using the terminal is of course also OK). You can use the "Add file" button
+    to upload files:
+    ```{figure} img/github-upload.png
+    :alt: Screenshot of Binder web interface
+
+    Screenshot of Binder web interface.
+    ```
+
+  ````{tabs}
+    ```{group-tab} Jupyter Notebooks
+    - Upload the notebook which we have created earlier to this repository. If you got stuck earlier,
+      you can download [this notebook](https://raw.githubusercontent.com/coderefinery/jupyter/main/example/darts.ipynb)
+      (right-click, "Save as ..."). You can also try this with a different notebook. 
+
+    - Add also a `requirements.txt` file which contains (adapt this if your notebook has other dependencies):
+      ```
+      numpy==1.26.4
+      matplotlib==3.4.1
+      ```
+    ```
+    ```{group-tab} R Markdown/R Studio project
+    This exercise is for those who use Rmd files instead of Jupyter notebooks.
+
+    - Upload or push your Rmd file to this GitHub repository.
+
+    - Add a file `runtime.txt` which specifies the R version you want to use:
+      ```
+      r-3.6-2020-10-13
+      ```
+
+    - Add a file `install.R` which lists the dependencies, for instance:
+      ```
+      install.packages(c("readr", "ggplot2"))
+      ```
+
+    - After you have done that, visit
+      https://mybinder.org/v2/gh/**USER**/**REPOSITORY**/**BRANCH**?urlpath=rstudio (adapt
+      "USER", "REPOSITORY", and "BRANCH").
+
+    - For more information, see [this
+      guide](https://github.com/alan-turing-institute/the-turing-way/blob/master/workshops/boost-research-reproducibility-binder/workshop-presentations/zero-to-binder-r.md).
+    ```
+  ````
+
+  - Visit [https://mybinder.org](https://mybinder.org):
+    ```{figure} img/binder.jpg
+    :alt: Screenshot of Binder web interface
+
+    Screenshot of Binder web interface.
+    ```
+  - Copy-paste the markdown text for the mybinder badge into a README.md file in your notebook repository.
+
+  - Check that your notebook repository now has a "launch binder"
+    badge in your `README.md` file on GitHub.
+
+  - Try clicking the button and see how your repository is launched
+    on Binder (can take a minute or two). Your notebooks can now be expored and executed in the cloud.
+
+  - Enjoy being fully reproducible!
+`````
+
+```{keypoints} More examples with Binder:
+- [Binder documentation](https://mybinder.readthedocs.io/en/latest/introduction.html)
+- [Collection of example repositories](https://github.com/binder-examples)
+```
 
 
 ## How to get a digital object identifier (DOI)