.renku/renku.ini

-[renku "interactive"]
+[interactive]
 default_url = /lab
+mem_request = 8G
+lfs_auto_fetch = true
+disk_request = 4G
+
+[renku]
+autocommit_lfs = false
+lfs_threshold = 100kb
+

README.md

@@ -3,36 +3,55 @@
 ## Introduction
 
 This is a Renku project - basically a git repository with some
-bells and whistles. You'll find we have already created some
-useful things like `data` and `notebooks` directories and
-a `Dockerfile`.
+bells and whistles. This is how to do the exercises on Renku. 
 
-## Working with the project
+## Fork the Project
 
-The simplest way to start your project is right from the Renku
-platform - just click on the `Environments` tab and start a new session.
-This will start an interactive environment right in your browser.
+After Clicking on the ADML HSLU HS22 Project, you have a button "Fork" on the overview tab. When clicking on it you can duplicate this repository in your own namespace. 
 
-To work with the project anywhere outside the Renku platform,
-click the `Settings` tab where you will find the
-git repo URLs - use `git` to clone the project on whichever machine you want.
+![Alt text](img/fork.png "Where to find the Fork Button")
 
-### Changing interactive environment dependencies
+Below you see the prompt you get when clicking on the Fork Button, you don't need to change anything just click on "Fork Project". (You won't get the title error as I do, because you don't have this repository yet.) 
 
-Initially we install a very minimal set of packages to keep the images small.
-However, you can add python and conda packages in `requirements.txt` and
-`environment.yml` to your heart's content. If you need more fine-grained
-control over your environment, please see [the documentation](https://renku.readthedocs.io/en/latest/user/advanced_interfaces.html#dockerfile-modifications).
+![Alt text](img/fork_prompt.png )
 
-## Project configuration
+This has the advantage that you can save the changes to your notebook while working on it. When now going on your project page you have two "ADML HSLU HS22" project one with your namespace - this is the one you need to use from now on. 
+**Always use the ADML HSLU HS22 project with your name below**
 
-Project options can be found in `.renku/renku.ini`. In this
-project there is currently only one option, which specifies
-the default type of environment to open, in this case `/lab` for
-JupyterLab. You may also choose `/tree` to get to the "classic" Jupyter
-interface.
+![Alt text](img/your_project.png )
+
+## Starting a Session
+
+Click on the project and go to the Sessions tab, and click on the "New Session button".
+
+![Alt text](img/new_session.png )
+
+When opening a session the first time after forking the project, you will encounter the Docker Image no available Error. This is not a problem, just click on building the branch image. It will now build your docker image. This can take some minutes. Afterwards click on the "Start Session" button and you have a running session which looks like this:
+
+![Alt text](img/session_overview.png )
+
+Click on the Open button and your Session will start. Or click on the three dots and choose open in new tab to have a better readability. Now you should see the folder structure as it is in the repository, open the notebook folder and you can see the notebooks adn open them by clicking on them.
+
+![Alt text](img/folder_structure.png )
+
+To save your work you can click on the save button from time to time.
+
+![Alt text](img/saving.png )
+
+Then in the menu bar on the left, click on the third symbol (git-symbol).
+
+![Alt text](img/git_interface.png )
+
+Then click on the plus, next to the "Changed" tab, like this your changes are added in the repository.
+
+![Alt text](img/add_change.png )
+
+In a last step, write a short description of what you did e.g. "Worked on Exercise 08B", and then click on the commit button. In this way, when opening a news session your changes will be restored.
+
+![Alt text](img/commit.png )
+
+## Advanced Use
+
+If you are familiar with git you can use the project as a normal git repository, open it on GitLab and even open Sessions from different commits. 
 
-## Moving forward
 
-Once you feel at home with your project, we recommend that you replace
-this README file with your own project documentation! Happy data wrangling!