AdvLabDB/docs/user_docs/assistant.adoc

= Assistant's documentation

== Welcome
Welcome to this website, AdvLabDB, where you will be able to manage your lab assistance. Please, *read this documentation* to familiarize yourself with this website.

== Menu items
In this section, 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.

=== Group Experiment
Here, you will find all the experiments you are responsible for paired with the groups that are doing these experiments in this semester. You can add an optional note specific to a pair of group and experiment. Examples for such a note:
* Protocol received
* Submission until ...
* etc.

This note can be **seen and edited** by admins and assistants that are responsible for this semester experiment (if you are not the only one who is responsible for this experiment and group pair).

To edit the note, click on the pen on the left of a row.

=== 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 chosen in the semester break.

To edit the date of an appointment, click on the date (underlined fields are editable). Then, choose the new date and click on the check mark.

=== 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.

*IMPORTANT:* #Oral and protocol marks are between 0 and 15!#

To edit an oral or protocol mark, click on the pen icon in a row. Then, enter the mark(s) and click on _Save_.

You can use the search bar to find a student by a part of the name or an email.

=== 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, especially if you are a new assistant. To edit these fields, click on the pen icon at the left of 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 latest semester. You should only work in an old semester if there are still experiment marks to be set in the old semester.
Add assistant's docs 2022-05-30 13:37:15 +00:00			`= Assistant's documentation`

Update admin and assistant docs 2022-05-30 15:25:50 +00:00			`== Welcome`
Fix important in embedding mode 2022-05-30 18:36:23 +00:00			`Welcome to this website, AdvLabDB, where you will be able to manage your lab assistance. Please, read this documentation to familiarize yourself with this website.`
Add assistant's docs 2022-05-30 13:37:15 +00:00
Update admin and assistant docs 2022-05-30 15:25:50 +00:00			`== Menu items`
			`In this section, you will find explanations to each menu item on the upper navigation bar.`

			`=== Home`
Add assistant's docs 2022-05-30 13:37:15 +00:00			`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.`

Add note to assistantSpace 2022-06-17 20:20:42 +00:00			`=== Group Experiment`
			`Here, you will find all the experiments you are responsible for paired with the groups that are doing these experiments in this semester. You can add an optional note specific to a pair of group and experiment. Examples for such a note:`
			`* Protocol received`
			`* Submission until ...`
			`* etc.`

			`This note can be seen and edited by admins and assistants that are responsible for this semester experiment (if you are not the only one who is responsible for this experiment and group pair).`

			`To edit the note, click on the pen on the left of a row.`

Update admin and assistant docs 2022-05-30 15:25:50 +00:00			`=== Appointment`
Fix typos 2022-05-30 16:42:02 +00:00			`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 chosen in the semester break.`
Add assistant's docs 2022-05-30 13:37:15 +00:00
Update admin and assistant docs 2022-05-30 15:25:50 +00:00			`To edit the date of an appointment, click on the date (underlined fields are editable). Then, choose the new date and click on the check mark.`

			`=== Experiment Mark`
Add assistant's docs 2022-05-30 13:37:15 +00:00			`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.`

Fix important in embedding mode 2022-05-30 18:36:23 +00:00			`IMPORTANT: #Oral and protocol marks are between 0 and 15!#`
Update admin and assistant docs 2022-05-30 15:25:50 +00:00
Update assistants's docs 2022-06-01 22:11:32 +00:00			`To edit an oral or protocol mark, click on the pen icon in a row. Then, enter the mark(s) and click on _Save_.`
Add assistant's docs 2022-05-30 13:37:15 +00:00
Update admin and assistant docs 2022-05-30 15:25:50 +00:00			`You can use the search bar to find a student by a part of the name or an email.`

			`=== User`
Update assistants's docs 2022-06-01 22:11:32 +00:00			`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, especially if you are a new assistant. To edit these fields, click on the pen icon at the left of the single entry in the table. After editing, click on _Save_.`
Add assistant's docs 2022-05-30 13:37:15 +00:00
			`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.`

Update admin and assistant docs 2022-05-30 15:25:50 +00:00			`=== Docs`
Add assistant's docs 2022-05-30 13:37:15 +00:00			`This is a link which leads you to this page.`

Update admin and assistant docs 2022-05-30 15:25:50 +00:00			`=== Active semester`
Add assistant's docs 2022-05-30 13:37:15 +00:00			`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.`

Fix typos 2022-05-30 16:42:02 +00:00			`If you see a warning that you are in an old semester, click on _Active semester_ and choose the latest semester. You should only work in an old semester if there are still experiment marks to be set in the old semester.`