en/documentation/SharingFromArtemis.md

@@ -2,13 +2,32 @@
 
 For the time being, we have implemented an initial infrastructure to export Artemis programming exercises to the sharing platform. To do so, follow the steps below:
 
-1. Register in the sharing platform (unless not done already), and request the administrators for the "sharing"-group permissions.
-2. Login into [Artemis](https://artemis.codeability.uibk.ac.at/)
-3. Navigate to the course management page and click ![image](uploads/4fdfd40df6643257fcac65bda64ea100/image.png) of the course containing the exercise you want to share
-4. Click on the **Title** (or **ID**) of the exercise (this will navigate you to the exercise's detail page)
-5. Click the ![image](uploads/b91cfb6d1d28a57643ba22fd2259e816/image.png) button (you will be redirected to the [Sharing Plattform](https://search.sharing-codeability.uibk.ac.at/))
-6. Login using your credentials or through **Gitlab SSO** in the [Sharing Plattform](https://search.sharing-codeability.uibk.ac.at/)
-7. An **Import exercise** page will be displayed, were you can edit the metadata of the imported exercise (*this won't affect the exercise in Artemis*)
-8. After filling out the **import form**, click the ![image](uploads/0d9e8c57682090748b3e83b1da0a4a1c/image.png) button (A list of Gitlab groups for which you have the needed permissions will be displayed)
-9. Select the Gitlab group were you want to store/share the exercise (*This might take several seconds to complete*)
-10. Upon successful import, you will be redirected back to Artemis
\ No newline at end of file
+### Setup repository group
+
+1. Register in the [Sharing Plattform](https://search.sharing-codeability.uibk.ac.at/) (unless not already done), an require the administrator role for the "sharing"-group permission. 
+
+2. Create a new subgrup below the sharing-hierarchy and your university (e.g. https://sharing-codeability.uibk.ac.at/sharing/university-innsbruck/). ***Skip this step if the subgroup you want to import the exercise to, already exists***
+
+### Export exercise from Artemis
+
+1. Login into [Artemis](https://artemis.codeability.uibk.ac.at/)
+
+2. Navigate to the course management page and click ![image](uploads/4fdfd40df6643257fcac65bda64ea100/image.png) of the course containing the exercise you want to share
+
+3. Click on the **Title** (or **ID**) of the exercise (this will navigate you to the exercise's detail page)
+
+4. Click the ![image](uploads/b91cfb6d1d28a57643ba22fd2259e816/image.png) button. (You will be redirected to the [Sharing Plattform](https://search.sharing-codeability.uibk.ac.at/))
+
+5. Login using your credentials or through **Gitlab SSO** in the [Sharing Plattform](https://search.sharing-codeability.uibk.ac.at/)
+
+6. An **Import exercise** page will be displayed, were you can edit the metadata of the imported exercise (*this won't affect the exercise in Artemis*)
+
+![Screenshot_from_2021-10-04_10-28-21](uploads/4be8e69d0b457f441dbb1df3062f2a10/Screenshot_from_2021-10-04_10-28-21.png)
+
+7. After filling out the **import form**, click the ![image](uploads/0d9e8c57682090748b3e83b1da0a4a1c/image.png) button (A list of Gitlab groups for which you have the needed permissions will be displayed)
+
+![Screenshot_from_2021-10-04_10-33-44](uploads/bc7670fa1b225dd6ba8015a3dd098e12/Screenshot_from_2021-10-04_10-33-44.png)
+
+8. Select the Gitlab group were you want to store/share the exercise (*This might take several seconds to complete*)
+
+9. Upon successful import, you will be redirected back to Artemis
\ No newline at end of file