Refine student quickstart and add Artemis launch flow

Add clear first-login/start instructions, integrate Artemis+Scorpio onboarding screenshots, and update submission guidance so students can launch and submit from either path.

Author: CodeByNikolas

docs/student/getting-started/first-login.md

@@ -1,15 +1,32 @@
 ---
 title: First Login
-description: Mock onboarding guide for students.
+description: Sign in and reach the app launcher.
 ---
 
 # First Login
 
-This mock page represents the first-run learner experience.
+Use this page for your first login flow.
 
-## Mock onboarding steps
+## 1) Open the login page
 
-1. Sign in with the course account
-2. Join the correct course space
-3. Launch the first workspace
-4. Confirm editor, files, and terminal access
+Open `https://theia.artemis.cit.tum.de/` in your browser.
+
+![Landing page with login button](/img/student/getting-started/first-login-01-landing-login.png)
+
+## 2) Sign in with your account
+
+Complete the login flow shown by your course setup.
+
+<img src="/img/student/getting-started/first-login-02-sign-in-form.png" alt="Sign-in form" style={{maxHeight: 520}} />
+
+## 3) Confirm you reached the launcher
+
+After login, you should see the IDE app tiles.
+
+![IDE launcher after login](/img/student/getting-started/first-login-03-launcher-after-login.png)
+
+## Next step
+
+Continue with [First Start](./first-start.md).
+
+If your course starts from Artemis exercises, you can also use [Start from Artemis](./start-from-artemis.md).

docs/student/getting-started/first-start.md

@@ -0,0 +1,44 @@
+---
+title: First Start
+description: Launch your first Java workspace in under two minutes.
+---
+
+# First Start
+
+Use this page for your first start.
+
+## 1) Open the launcher
+
+After login, go to the IDE launcher page with the app tiles.
+
+<img src="/img/student/getting-started/first-login-03-launcher-after-login.png" alt="IDE launcher page" style={{maxHeight: 520}} />
+
+## 2) Launch Java
+
+Click **Launch Java**.
+
+![Launch Java tile](/img/student/getting-started/student-02-launch-java-tile.png)
+
+## 3) Wait for the IDE to open
+
+The IDE opens in a new session URL.
+
+![Java workspace opened](/img/student/getting-started/student-03-ide-opened-welcome.png)
+
+## 4) Quick success check
+
+Open a terminal and run:
+
+```bash
+java -version
+```
+
+If you see a Java version output, your workspace is ready.
+
+![Terminal java version check](/img/student/getting-started/student-04-java-version-terminal.png)
+
+## Next step
+
+Continue with the [Workspace Tour](./workspace-tour.md).
+
+If your course launches from Artemis, use [Start from Artemis](./start-from-artemis.md).

docs/student/getting-started/start-from-artemis.md

@@ -0,0 +1,30 @@
+---
+title: Start from Artemis
+description: Open your exercise in EduIDE directly from Artemis.
+---
+
+# Start from Artemis
+
+Use this path when you begin from an Artemis exercise page.
+
+## 1) Start the exercise
+
+Open your exercise in Artemis and click **Start exercise**.
+
+![Start exercise in Artemis](/img/student/getting-started/artemis-01-start-exercise.png)
+
+## 2) Open the online IDE
+
+In the repository section, click **Open online IDE**.
+
+![Open online IDE from Artemis](/img/student/getting-started/artemis-02-open-online-ide.png)
+
+## 3) First-login retry (current workaround)
+
+If you are asked to log in, complete login, return to the Artemis exercise page, and click **Open online IDE** again.
+
+This can happen on the first login.
+
+## 4) Continue in EduIDE
+
+When the IDE opens, continue with the [Workspace Tour](./workspace-tour.md).

docs/student/getting-started/workspace-tour.md

@@ -1,16 +1,37 @@
 ---
 title: Workspace Tour
-description: Mock workspace orientation for students.
+description: Quick orientation of the EduIDE layout.
 ---
 
 # Workspace Tour
 
-This placeholder page shows where a lightweight orientation guide would go.
+This is the minimal layout you need to start working.
 
-## Mock tour stops
+![IDE layout overview](/img/student/getting-started/workspace-tour-01-welcome-screen.png)
 
-- File explorer
-- Editor tabs
-- Terminal panel
-- Assignment instructions
-- Submission status
+## Main areas
+
+- **Explorer (left):** your files and folders
+- **Editor (center):** where you write code
+- **Terminal (bottom):** compile and run commands
+- **Problems (bottom):** diagnostics and warnings
+
+## Useful first action
+
+Open **Terminal -> New Terminal**.
+
+![Open new terminal from top menu](/img/student/getting-started/workspace-tour-02-open-terminal-menu.png)
+
+Open the terminal and run:
+
+```bash
+pwd
+```
+
+You should see your workspace path (usually `/home/project`).
+
+![Terminal current directory output](/img/student/getting-started/workspace-tour-03-terminal-pwd.png)
+
+## Next step
+
+Continue with the [Assignment Workflow](../learning/assignment-workflow.md).

docs/student/intro.md

@@ -1,16 +1,28 @@
 ---
 title: Student Overview
-description: Mock student-facing documentation landing page.
+description: Quickstart guide for students using EduIDE.
 ---
 
 # Student Overview
 
-This section is for learners using EduIDE in courses.
+Welcome to EduIDE. This guide helps you get coding quickly in your course workspace.
 
-It should stay simple, task-oriented, and separate from instructor or admin detail.
+You do not need local setup. Everything runs in your browser.
 
-## What lives here
+## Start here
 
-- First login and workspace orientation
-- Assignment and submission workflows
-- Practical help for common blockers
+1. [First Login](./getting-started/first-login.md)
+2. [First Start](./getting-started/first-start.md)
+3. [Start from Artemis](./getting-started/start-from-artemis.md)
+4. [Workspace Tour](./getting-started/workspace-tour.md)
+5. [Assignment Workflow](./learning/assignment-workflow.md)
+6. [Submission Checklist](./learning/submission-checklist.md)
+
+## What this section covers
+
+- logging in to the platform
+- launching your Java workspace
+- launching from Artemis exercises
+- navigating the IDE layout
+- editing, compiling, and running code from the terminal
+- submitting with the Scorpio extension and checking feedback

docs/student/learning/assignment-workflow.md

@@ -1,15 +1,48 @@
 ---
 title: Assignment Workflow
-description: Mock assignment workflow guide for students.
+description: Quick terminal-first workflow for Java assignments.
 ---
 
 # Assignment Workflow
 
-This mock page is the future home for practical guidance on completing and submitting coursework.
+Use this flow when you work on Java tasks.
 
-## Mock workflow
+## 1) Open the assignment file
 
-1. Read the assignment brief
-2. Work inside the provided workspace
-3. Run local checks before submitting
-4. Submit and review status feedback
+Open `BubbleSort.java` in the editor.
+
+![BubbleSort opened in editor](/img/student/learning/assignment-01-open-bubblesort.png)
+
+## 2) Make your code change
+
+Edit the method for your task.
+
+![BubbleSort after implementing method](/img/student/learning/assignment-02-edit-bubblesort.png)
+
+## 3) Run in terminal
+
+Run:
+
+```bash
+java BubbleSort.java
+```
+
+If there is an error, fix it and run the command again.
+
+![Run BubbleSort.java in terminal](/img/student/learning/assignment-03-run-bubblesort-command.png)
+
+
+## 4) Check the output
+
+Confirm that the program output matches the expected sorted order.
+
+![BubbleSort terminal output](/img/student/learning/assignment-04-run-bubblesort-output.png)
+
+## 5) Final quick check
+
+- file saved
+- program runs successfully
+- output matches expectation
+- ready to submit in Scorpio
+
+Then continue with the [Submission Checklist](./submission-checklist.md).

docs/student/learning/submission-checklist.md

@@ -1,15 +1,34 @@
 ---
 title: Submission Checklist
-description: Mock submission checklist for students.
+description: Submit with Scorpio and review feedback in Artemis flow.
 ---
 
 # Submission Checklist
 
-This placeholder page keeps learner support content focused and direct.
+Use this checklist to submit your work from the IDE.
 
-## Mock checklist
+## 1) Open Scorpio
 
-- Latest changes saved
-- Required tests executed
-- Submission target selected
-- Confirmation status recorded
+In the IDE activity bar, open **Artemis: Scorpio**.
+
+## 2) Verify exercise details
+
+Make sure the correct exercise and task are shown.
+
+## 3) Submit your exercise
+
+Click **Submit Exercise**.
+
+![Scorpio extension with submit button and feedback area](/img/student/learning/scorpio-01-submit-and-feedback.png)
+
+## 4) Review feedback
+
+Check the latest result in the same panel.
+
+If feedback is delayed, wait a moment and refresh the panel.
+
+## Done when
+
+- code is saved
+- submission was sent
+- latest feedback was checked

sidebarsStudent.ts

@@ -6,7 +6,12 @@ const sidebars: SidebarsConfig = {
     {
       type: 'category',
       label: 'Getting Started',
-      items: ['getting-started/first-login', 'getting-started/workspace-tour'],
+      items: [
+        'getting-started/first-login',
+        'getting-started/first-start',
+        'getting-started/start-from-artemis',
+        'getting-started/workspace-tour',
+      ],
     },
     {
       type: 'category',