From c0152c28aa77e89704fbbb95f8d75969fd990c60 Mon Sep 17 00:00:00 2001 From: Mo8it Date: Mon, 30 May 2022 15:37:15 +0200 Subject: [PATCH] Add assistant's docs --- docs/user_docs/assistant.adoc | 29 +++++++++++++++++++++++++++-- 1 file changed, 27 insertions(+), 2 deletions(-) diff --git a/docs/user_docs/assistant.adoc b/docs/user_docs/assistant.adoc index 1de8696..8a59361 100644 --- a/docs/user_docs/assistant.adoc +++ b/docs/user_docs/assistant.adoc @@ -1,2 +1,27 @@ -= Assistant documentation -// TODO \ No newline at end of file += Assistant's documentation + +On this page, you will find explanations to each menu item on the upper navigation bar. + +== Home +This is your home page. Here, you currently only find the number of *missing* final experiment marks for the experiments that you are assigned to. At the latest at the end of the semester, this number should be 0. A number higher than 0 means that some oral and/or protocol marks are missing. The final experiment mark is calculated automatically after the oral and protocol marks of an experiment are set. + +== Appointment +Here, you will find all the appointments you have for the experiments you are assigned to. You can only edit the _Date_ of an appointment. You should do so after writing with the students doing the experiment corresponding to the appointment. The initial date you find before editing it is only a suggestion in the week where the appointment should take place. If _Special_ is checked, then the date should be choosen in the semester break. + +== Experiment Mark +Here, you find the experiment marks that you have to fill for every student in every group. Students in a group have separate marks. The oral mark has to be set after the oral exam. The protocol mark has to be set after correcting the group's protocol. The final experiment mark is calculated automatically after the oral and protocol marks are set. + +To edit an oral or protocol mark, click on it (underlined fields are editable). Then, enter the mark and click on the check mark or press enter. + +== User +Here, you find a table with only one entry which is you as a user. Make sure that the fields _Phone Number_, _Mobile Phone Number_, _Building_ and _Room_ are filled and up to date. To edit these fields, click on the pen icon near the single entry in the table. After editing, click on _Save_. + +You can generate a new random password by clicking on the pen icon, checking the corresponding checkbox and then clicking on _Save_. You will be then logged out. Your new password is displayed above the login fields. Make sure that you save the password in a safe place. Using a free open source password manager like https://bitwarden.com/[Bitwarden^] or https://keepassxc.org/[KeepassXC^] is recommended. + +== Docs +This is a link which leads you to this page. + +== Active semester +An active semester is the semester you are working in. All shown experiment marks and appointments are in your active semester. By default as a new assistant, your active semester should be the latest semester. + +If you see a warning that you are in an old semester, click on _Active semester_ and choose the lastest semester. You should only work in an old semester if there are still experiment marks to be set in the old semester.