Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Help #410

Merged
merged 29 commits into from
May 10, 2024
Merged

Help #410

Show file tree
Hide file tree
Changes from 28 commits
Commits
Show all changes
29 commits
Select commit Hold shift + click to select a range
3add56b
chore: create help pages routes
tyboro2002 Apr 29, 2024
34bbbce
chore: added base layout and header for help
tyboro2002 Apr 29, 2024
110741c
chore: startup sidebar menu
tyboro2002 Apr 29, 2024
9740a87
chore: basic sidebar
tyboro2002 Apr 29, 2024
4b71059
chore: basic vitepress setup
tyboro2002 May 2, 2024
7ca8625
chore: make buttons on startpage work with i18n
tyboro2002 May 2, 2024
57fa9a7
chore: start student help nl
tyboro2002 May 2, 2024
7866a4f
chore: cleanup capitals
tyboro2002 May 2, 2024
ee67990
chore: student help page nl
tyboro2002 May 2, 2024
d4a34c0
chore: finished first draft of help for students
tyboro2002 May 2, 2024
0f653f4
Merge branch 'development' of github.com:SELab-2/UGent-7 into help
tyboro2002 May 2, 2024
1acb2ec
chore: lint fix
tyboro2002 May 2, 2024
23b2336
chore:teacher join command
tyboro2002 May 2, 2024
ae7b503
chore: fix linter
tyboro2002 May 2, 2024
2d97648
fix: little fixes
BramMeir May 2, 2024
33cae73
Merge branch 'development' of github.com:SELab-2/UGent-7 into help
tyboro2002 May 2, 2024
e60c531
fix: en translations
BramMeir May 2, 2024
490814e
Merge branch 'help' of github.com:SELab-2/UGent-7 into help
tyboro2002 May 2, 2024
07f6692
chore: small cleanup
tyboro2002 May 2, 2024
b608a37
chore: add scafolding for other types of users their help pages
tyboro2002 May 6, 2024
51eddae
chore: fix merge conflicts
tyboro2002 May 6, 2024
7ef5ad7
Merge branch 'development' of github.com:SELab-2/UGent-7 into help
tyboro2002 May 6, 2024
3373e30
Merge branch 'development' of github.com:SELab-2/UGent-7 into help
tyboro2002 May 10, 2024
a4e744e
chore: refactor to cleanup for other types of help pages
tyboro2002 May 10, 2024
bb55b13
chore: add teacher help page (wip)
tyboro2002 May 10, 2024
d8f0c7b
chore: add assistant help page (WIP)
tyboro2002 May 10, 2024
9a7e5aa
chore: add poetry.lock
tyboro2002 May 10, 2024
cab7e87
fix: little cleanup
BramMeir May 10, 2024
3aefaba
fix: assistants help
BramMeir May 10, 2024
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added docs/assets/assistant/en/course-create-button.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/assistant/en/modus-change.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/assistant/nl/course-create-button.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/assistant/nl/modus-change.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed docs/assets/modus-change.png
Binary file not shown.
File renamed without changes
Binary file added docs/assets/student/en/lang-change.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/student/en/logout-button.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/student/en/project-card.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/student/en/project-list.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/student/modus-change.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
File renamed without changes
Binary file added docs/assets/student/nl/lang-change.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/student/nl/logout-button.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/student/nl/project-card.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/student/nl/project-list.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/teacher/course-share-button.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/teacher/en/course-create-button.png
Binary file added docs/assets/teacher/en/modus-change.png
Binary file added docs/assets/teacher/en/private-course-button.png
Binary file added docs/assets/teacher/nl/course-create-button.png
Binary file added docs/assets/teacher/nl/modus-change.png
Binary file added docs/assets/teacher/nl/private-course-button.png
25 changes: 25 additions & 0 deletions docs/en/admin-examples.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# Admin Help Page

This page describes how to interact with Ypovoli as a admin.

## Login/Logout

**Login**

- On the login page, there is a button with the text "UGent login".

![login button](../assets/login-button.png)
- Click on this button. You will be redirected to the UGent login page.
- Select the desired account and follow the login steps. You will be redirected to the dashboard.

**Logout**

- Click on your name in the navigation bar.

![logout button](../assets/en/logout-button.png)

## Change Language

- Click on the arrow next to EN at the top of the navigation bar and select the desired language.

![language choice button](../assets/en/lang-change.png)
96 changes: 96 additions & 0 deletions docs/en/assistant-examples.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,96 @@
# Assistant Help Page

This page describes how to interact with Ypovoli as an assistant.

## Login/Logout

**Login**

- On the login page, there is a button with the text "UGent login".

![login button](../assets/login-button.png)
- Click on this button. You will be redirected to the UGent login page.
- Select the desired account and follow the login steps. You will be redirected to the dashboard.

**Logout**

- Click on your name in the navigation bar.

![logout button](../assets/en/logout-button.png)

## Change Language

- Click on the arrow next to EN at the top of the navigation bar and select the desired language.

![language choice button](../assets/en/lang-change.png)

## Change Mode

::: danger Caution!
- Only possible if the user has multiple roles like student, teacher, assistant, or admin.
:::

- Click on the arrow next to the currently selected role at the top of the navigation bar.
- Choose the new role with which you want to view the page.

![mode choice button](../assets/assistant/en/modus-change.png)

## Course Details
- Click on "Dashboard" in the navigation bar.
- Scroll down to the "My Courses" section.
- Click on the details button next to the desired course.

![course card](../assets/course-card.png)

::: tip
- If you want to view a course from a previous academic year, select the correct year in the academic year selector.
:::

## Creating a Project

- Option 1:
- Click on "Dashboard" in the navigation bar.
- Click on "Create new project".
- Option 2:
- Click on "Calendar" in the navigation bar.
- Click on "Create new project".
- Option 3:
- Go to the detail page of a course (see [Course Details](#course-details)).
- Scroll to "Current Projects".
- Click on the + button.

## Viewing Projects

![projects list](../assets/en/project-list.png)

- Option 1:
- Click on "Dashboard" in the navigation bar.
- At the top of the page, there is a "Current Projects" section.
::: info
- Here are all the projects with a deadline within the next 7 days on the left and all projects on the right.
- Use the toggle button at the top to view projects with expired deadlines.
:::
- Option 2:
- Click on "Calendar" in the navigation bar.
- On the calendar, an indication of the number of deadlines on a specific day is given using a red circle.
- Select a day with projects and click on the desired project.
- Option 3:
- Click on "Dashboard" in the navigation bar.
- Scroll to the "My Courses" section.
- Click on the course of the desired project.
- Under the "Current Projects" section, you will see all projects for this specific course.
- Option 4:
- Click on "Projects" in the navigation bar.
- You will see an overview of all your projects.

::: info Project Card Explanation
<!-- TODO maybe add a photo and indicate with numbers -->
![project card](../assets/en/project-card.png)

The card is divided as follows:
- Name of the associated course.
- Brief description of this course.
- Start date and deadline of the project.
- Progress bar of all students, including the number of submissions and the number of groups.
- Status of the tests performed for these submissions.
:::
10 changes: 5 additions & 5 deletions docs/en/student-examples.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,13 +34,13 @@ This page describes how to interact with Ypovoli as a student.
- Click on the arrow next to the currently selected role at the top of the navigation bar.
- Choose the new role with which you want to view the page.

![mode choice button](../assets/modus-change.png)
![mode choice button](../assets/student/modus-change.png)

## Enroll in/Leave Course

<div style="display: flex; align-items: center;">
<img src="../assets/en/join-course.png" alt="course enroll button" style="width: auto; height: auto; margin-right: 10px;">
<img src="../assets/en/leave-course.png" alt="course leave button" style="width: auto; height: auto;">
<img src="../assets/student/en/join-course.png" alt="course enroll button" style="width: auto; height: auto; margin-right: 10px;">
<img src="../assets/student/en/leave-course.png" alt="course leave button" style="width: auto; height: auto;">
</div>

**Enroll**
Expand Down Expand Up @@ -117,13 +117,13 @@ This page describes how to interact with Ypovoli as a student.

**Join**

![group join](../assets/en/group-join.png)
![group join](../assets/student/en/group-join.png)
- Go to the detail page for the chosen project.
- Click on the chosen group and click on "Choose group".
- You are successfully enrolled in this group.

**Leave**
![group leave](../assets/en/group-leave.png)
![group leave](../assets/student/en/group-leave.png)
- Go to the project detail page.
- Click on leave group.

Expand Down
124 changes: 124 additions & 0 deletions docs/en/teacher-examples.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,124 @@
# Teacher Help Page

This page describes how to interact with Ypovoli as a teacher.

## Login/Logout

**Login**

- On the login page, there is a button with the text "UGent login".

![login button](../assets/login-button.png)
- Click on this button. You will be redirected to the UGent login page.
- Select the desired account and follow the login steps. You will be redirected to the dashboard.

**Logout**

- Click on your name in the navigation bar.

![logout button](../assets/en/logout-button.png)

## Change Language

- Click on the arrow next to EN at the top of the navigation bar and select the desired language.

![language choice button](../assets/en/lang-change.png)

## Change Mode

::: danger Caution!
- Only possible if the user has multiple roles like student, teacher, assistant, or admin.
:::

- Click on the arrow next to the currently selected role at the top of the navigation bar.
- Choose the new role with which you want to view the page.

![mode choice button](../assets/teacher/en/modus-change.png)

## Creating a Course
- Click on "Dashboard" in the navigation bar.
- Scroll down to the "My Courses" section.
- Click on the + button.

![course creation button](../assets/teacher/en/course-create-button.png)

:::info
If you only want to make your course available via an invitation link, you can do so using this button.
![private course button](../assets/teacher/en/private-course-button.png)

:::danger
- Activate this link via the share button (maximum validity is 28 days).
<div style="display: flex; align-items: center;">
<img src="../assets/teacher/course-share-button.png" alt="course share button" style="width: auto; height: 75px; margin-right: 10px;">
</div>
:::

## Course Details
- Click on "Dashboard" in the navigation bar.
- Scroll down to the "My Courses" section.
- Click on the details button next to the desired course.

![course card](../assets/course-card.png)

::: tip
- If you want to view a course from a previous academic year, select the correct year in the academic year selector.
:::

## Creating a Project

- Option 1:
- Click on "Dashboard" in the navigation bar.
- Click on "Create new project".
- Option 2:
- Click on "Calendar" in the navigation bar.
- Click on "Create new project".
- Option 3:
- Go to the detail page of a course (see [Course Details](#course-details)).
- Scroll to "Current Projects".
- Click on the + button.

## Viewing Projects

![projects list](../assets/en/project-list.png)

- Option 1:
- Click on "Dashboard" in the navigation bar.
- At the top of the page, there is a "Current Projects" section.
::: info
- Here are all the projects with a deadline within the next 7 days on the left and all projects on the right.
- Use the toggle button at the top to view projects with expired deadlines.
:::
- Option 2:
- Click on "Calendar" in the navigation bar.
- On the calendar, an indication of the number of deadlines on a specific day is given using a red circle.
- Select a day with projects and click on the desired project.
- Option 3:
- Click on "Dashboard" in the navigation bar.
- Scroll to the "My Courses" section.
- Click on the course of the desired project.
- Under the "Current Projects" section, you will see all projects for this specific course.
- Option 4:
- Click on "Projects" in the navigation bar.
- You will see an overview of all your projects.

::: info Project Card Explanation
<!-- TODO maybe add a photo and indicate with numbers -->
![project card](../assets/en/project-card.png)

The card is divided as follows:
- Name of the associated course.
- Brief description of this course.
- Start date and deadline of the project.
- Progress bar of all students, including the number of submissions and the number of groups.
- Status of the tests performed for these submissions.
:::

## Searching and Editing Course Instructors
- Go to the detail page of the course (see [Course Details](#course-details)).
- Scroll to the "Instructors Linked to This Course" section.
- Here you will find a list of the instructors for this course.

::: info
- Via the edit button, you can add/remove instructors to/from this course.
- Via the trash can icon, you can remove instructors from this course (only if there is more than one remaining instructor).
:::
25 changes: 25 additions & 0 deletions docs/nl/admin-examples.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# Admin help pagina

Deze pagina beschrijft hoe u als administrator met Ypovoli interageert.

## Login/Logout

**Login**

- Op de login pagina staat een knop met tekst UGent login.

![login knop](../assets/login-button.png)
- Druk op deze knop. U wordt doorverwezen naar de UGent inlogpagina.
- Selecteer het gewenste account en volg de login stappen. U wordt doorverwezen naar het dashboard.

**Logout**

- Druk op uw naam in de navigatiebalk.

![logout knop](../assets/nl/logout-button.png)

## Taal veranderen

- Druk bovenaan in de navigatiebalk op het pijltje naast NL en selecteer de gewenste taal.

![taal keuze knop](../assets/nl/lang-change.png)
Loading