dodona-edu · bmesuere · Sep 5, 2020 · Aug 12, 2020 · Aug 12, 2020 · Aug 12, 2020
diff --git a/.vuepress/config.js b/.vuepress/config.js
@@ -142,6 +142,10 @@ function getGuidesSidebar(lang, groupTitle, FirstItem) {
       sidebarDepth: 2,
       children: [
         ['', FirstItem],
+        'for-students/',
+        'login-and-settings-for-students/',
+        'courses-for-students/',
+        'exercises-for-students/',
         'getting-started/',
         'pycharm-plugin/',
         'new-exercise-repo/',

diff --git a/.vuepress/styles/index.styl b/.vuepress/styles/index.styl
@@ -6,3 +6,13 @@
 
 .home .hero img
   max-width 450px!important
+
+.guilabel
+  border 1px solid #7fbbe3
+  background #e7f2fa
+  font-size 80%
+  font-weight 700
+  border-radius 4px
+  padding 2.4px 6px
+  margin auto 2px
+  white-space nowrap
diff --git a/en/guides/courses-for-students/README.md b/en/guides/courses-for-students/README.md
@@ -0,0 +1,12 @@
+---
+title: Course guide for students
+description: "Tutorial: course guide for students"
+---
+
+## Navigating to a course
+
+Course managers can build [courses]() out of [exercises]() grouped in [exercise series](). If you are [registered]() for a course it is possible to submit solutions for exercises belonging to that course. There are different places you can select a course:
+
+- On the left side of your homepage, there are cards for all the courses you are registered in, grouped by academic year. Use the search bar at the top of the homepage to search for a specific course by searching for the name of the course, the teacher, or the academic year. Select a course by clicking on the colored title bar on the card of the course or by clicking on <span class="guilabel">GO TO THIS COURSE</span> at the bottom of the course card.
+
+- If you have pending registration requests for courses, then you can find these courses in the panel <span class="guilabel">Awaiting approval</span> in the right column of your homepage. You can select one of these courses by clicking on its name.
diff --git a/en/guides/courses-for-students/course_exercise_status_icons/green_check.png b/en/guides/courses-for-students/course_exercise_status_icons/green_check.png
diff --git a/en/guides/courses-for-students/course_exercise_status_icons/red_check.png b/en/guides/courses-for-students/course_exercise_status_icons/red_check.png
diff --git a/en/guides/courses-for-students/course_exercise_status_icons/red_cross.png b/en/guides/courses-for-students/course_exercise_status_icons/red_cross.png
diff --git a/en/guides/for-students/README.md b/en/guides/for-students/README.md
@@ -0,0 +1,16 @@
+---
+title: Starting with Dodona as a student
+description: "Tutorial: starting with Dodona as a student"
+---
+
+# Dodona for students
+
+As a student, you can [register]() for one or more courses. Every course has [exercises]() that are grouped in [series](). For each [exercise]() an arbitrary amount of [solutions]() can be [submitted](). These submissions will automatically be judged and annotated with [feedback](). All the actions mentioned require you to have an [account]() and that you are [logged in]() on Dodona.
+
+## Get in touch
+
+If you have any questions about the way Dodona works or any interesting ideas that you want to share about the extension or enhancement of the platform, don't hesitate to contact us. Any comments and/or suggestions are more than welcome. Contacting us can be done by navigating to the **contact page** by clicking on the <span class="guilabel">Contact</span> button in the **footer** (at the bottom of every page).
+
+![image](./contact.en.png)
+
+Fill the information in the panel <span class="guilabel">Get in touch</span> and when you are ready press on the send button in the upper right corner of the panel.
diff --git a/en/guides/for-students/contact.en.png b/en/guides/for-students/contact.en.png
diff --git a/en/guides/login-and-settings-for-students/README.md b/en/guides/login-and-settings-for-students/README.md
@@ -0,0 +1,110 @@
+---
+title: Sign-in and user settings
+description: "Tutorial: sign-in and user settings"
+---
+
+## Selecting a language
+
+In Dodona, you have two **languages** to choose from, Dutch and English. To change your language use the **language menu** on the right side of the **navigation bar** (which can be found at the top of each page).
+
+![image](./choose_language.en.png)
+
+If you select a [language]() while you are logged in, it will be set as your preferred language in your [user settings]().
+
+::: details Note
+
+The language used for fixed components of Dodona (menubar, course structure, notifications, ...) are shown is fully controlled by the platform. These components are always shown in the selected [language]().
+
+The name and description of a [course]() are fixed, as are names and descriptions of  [exercise series]() within a course. These components do not depend on the selected  [language](). The language of these components falls entirely under the control of the course administrators that created the course.
+
+The name and description of an [exercise]() depend on the selected [language](). If a translation of the name and description was provided in the selected language when creating the exercise, theses components of the exercise will also be displayed in that language.
+
+The language of feedback on a submitted solution for an exercise is completely under the control of the judge with which the exercise is associated. The judge can make the language of this feedback depend on the language selected at the time the solution is submitted.
+:::
+
+## Sign-in
+
+To be able to sign-in you need a user account on Dodona. In the associated user profile, you can set your personal preferences on your user profile to personalize your experience. All the actions you perform &mdash; like registering for a course or submitting a solution &mdash; are linked with your user account.
+
+::: tip Important
+
+Sign-in on Dodona can be done by selecting your educational institution on the login page. As a High School student, you can also use your Smartschool, Office 365, or G Suite account provided by your school.
+
+:::
+
+Press on <span class="guilabel">Sign in</span>  on the right side of the navigation bar or navigate to the homepage and press on <span class="guilabel">Sign in</span> that can be found in the center of the homepage.
+
+![image](./login.en.png)
+
+
+::: tip
+
+You can only log in if you aren't already logged in. You can see that you are logged out if you can see the <span class="guilabel">Sign in</span> button on the right side of the [navigation bar](). If you are logged in, the name of your account can be seen at the same place. This is the [user menu]().
+:::
+
+Select your educational or research institution on the login page. If you are a High School student you can select the Smartschool, Office 365, or G Suite options. After selecting your preferred login, follow the specified log in procedure.
+
+![image](./institution.en.png)
+
+::: tip Important
+
+A few educational or research institutions explicitly ask for your permission to send some personal data to Dodona. Mostly you only need to give these permissions once per computer you use to log in. Dodona uses the personal data only for the internal management of your user profile and never exchanges this information with third parties.
+:::
+
+::: details Note
+
+The authentication of user accounts from external educational or research institutions, Dodona supports both [SAML](https://en.wikipedia.org/wiki/Security_Assertion_Markup_Language) and [OAuth](https://en.wikipedia.org/wiki/OAuth). Ask an IT administrator or teacher from your educational or research institution to contact us if you would like to give access to all the user accounts of your institution to Dodona. This service is free.
+:::
+
+If this is the first time you log in on Dodona, a new user account will automatically be created using the personal data sent by your external educational or research institution. In the user profile of this user account, you can set personal preferences for the language and time zone used by Dodona.
+
+::: tip Important
+
+If you have user accounts from different educational or research institutions, each one will correspond to a separate user account on Dodona.
+:::
+
+::: tip
+
+If you want to change to another user account than the one you are currently logged in with, then you need to log out and log in with the other user account.
+:::
+
+If you are logged in the **user menu** with your user name will be visible on the right side of the navigation bar. The user menu is at the place where the <span class="guilabel">Sign in</span> button was before you logged in.
+
+![image](./student.user_menu.en.png)
+
+When logged in the homepage will change to a personalized page with an overview of all the courses for which you are registered, their exercise series with a deadline, and your progress on submitting solutions for the exercises. This makes it easy to recognize if you are logged in or not.
+
+::: tip
+
+You can navigate to your homepage or to the neutral homepage (if you aren't logged in) from any page by clicking on the <span class="guilabel">Dodona</span> button on the left side of the navigation bar.
+![image](./student.navigate_to_homepage.en.png)
+:::
+
+If this is your first time you log in on Dodona you won't be registered in any courses and you won't have any submitted solutions. Because of this your homepage will seem a bit empty.
+
+![image](./student.homepage.en.png)
+
+## Setting your personal preferences
+
+Choose <span class="guilabel">My profile</span> in the [user menu]() on the right side of the [navigation bar](#selecteren-van-de-taal) to navigate to your **profilepage**.
+
+On your profile page, you can see your **personal data** (first name, family name, user name, and e-mail address) and a few **personal preferences** that together form your profile page. Dodona uses the user profile to personalize your user experience.
+
+![image](./student.user_menu_my_profile.en.png)
+
+Press on the edit button on the upper right corner of your profile page to edit your user profile. You can't edit your personal data. It gets automatically changed based on the personal data sent to Dodona by the external educational or research institution that was used during the login.
+
+![image](./student.edit_profile.en.png)
+
+In your user profile, you can set the timezone that should be used for all the time indications on the platform (for example the time at which your solution was submitted or the deadline for a series of exercises).
+
+![image](./student.edit_timezone.en.png)
+
+::: tip
+
+If the timezone of your user profile doesn't match with the local timezone as the timezone detected by your browser, then you will get a notification indicating that all time indications on the platform do not correspond to the local timezone.
+
+![image](./student.wrong_timezone.en.png)
+
+You can only remove this notification by setting the timezone in your user profile to the local timezone. Notice that the notification contains a link that will directly send you to your profile page.
+:::
diff --git a/en/guides/login-and-settings-for-students/choose_language.en.png b/en/guides/login-and-settings-for-students/choose_language.en.png
diff --git a/en/guides/login-and-settings-for-students/institution.en.png b/en/guides/login-and-settings-for-students/institution.en.png
diff --git a/en/guides/login-and-settings-for-students/login.en.png b/en/guides/login-and-settings-for-students/login.en.png
diff --git a/en/guides/login-and-settings-for-students/student.edit_profile.en.png b/en/guides/login-and-settings-for-students/student.edit_profile.en.png
diff --git a/en/guides/login-and-settings-for-students/student.edit_timezone.en.png b/en/guides/login-and-settings-for-students/student.edit_timezone.en.png
diff --git a/en/guides/login-and-settings-for-students/student.homepage.en.png b/en/guides/login-and-settings-for-students/student.homepage.en.png
diff --git a/en/guides/login-and-settings-for-students/student.navigate_to_homepage.en.png b/en/guides/login-and-settings-for-students/student.navigate_to_homepage.en.png
diff --git a/en/guides/login-and-settings-for-students/student.user_menu.en.png b/en/guides/login-and-settings-for-students/student.user_menu.en.png
diff --git a/en/guides/login-and-settings-for-students/student.user_menu_my_profile.en.png b/en/guides/login-and-settings-for-students/student.user_menu_my_profile.en.png
diff --git a/en/guides/login-and-settings-for-students/student.wrong_timezone.en.png b/en/guides/login-and-settings-for-students/student.wrong_timezone.en.png
diff --git a/nl/guides/README.md b/nl/guides/README.md
@@ -7,6 +7,7 @@ sidebarDepth: 0
 Hier vind je enkele handleidingen, vooral gericht op lesgevers.
 
 ## In het Nederlands
+* [Dodona voor studenten](for-students)
 * [Van start met Dodona](getting-started)
 * [Dodona PyCharm plugin](pycharm-plugin)
 * [Een nieuwe repository met oefeningen maken](new-exercise-repo)