Add MkDocs GitHub Pages, libdoc keyword docs, and Robocop CI

MkDocs + GitHub Pages:
- Add mkdocs.yml with Material theme, navigation, and extensions
- Rename docs to clean filenames (drop numeric prefixes)
- Create docs/index.md for MkDocs homepage
- Add .github/workflows/docs.yml for automated deployment
- Enable GitHub Pages with Actions deployment

Libdoc keyword documentation:
- Add scripts/generate_keyword_docs.py (libdoc JSON → Markdown)
- Generate docs/keywords/*.md for all 5 resource files
- Add keyword docs section to MkDocs navigation

Robocop code quality:
- Add "minimal" ruleset v0.1.0 to pyproject.toml [tool.robocop.lint]
- Add lint job to robot-tests.yml (separate from test job)
- Add robocop step to pr-feedback.yml with PR comment integration
- Fix DOC01 warnings in 3 test files (missing keyword docs)
- Add mkdocs-material and mkdocs to docs dependency group

Author: HackXIt

.github/workflows/docs.yml

@@ -0,0 +1,56 @@
+name: Deploy Documentation
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'docs/**'
+      - 'mkdocs.yml'
+      - 'resources/*.resource'
+      - 'scripts/generate_keyword_docs.py'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: uv sync --no-dev --group docs
+
+      - name: Generate keyword documentation
+        run: uv run python scripts/generate_keyword_docs.py
+
+      - name: Build MkDocs site
+        run: uv run mkdocs build
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: site/
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/pr-feedback.yml

@@ -28,6 +28,13 @@ jobs:
       - name: Install dependencies
         run: uv sync --locked
 
+      - name: Run Robocop lint
+        id: robocop
+        continue-on-error: true
+        run: |
+          uv run robocop check tests/ resources/ 2>&1 | tee robocop-output.txt
+          echo "exit_code=$?" >> $GITHUB_OUTPUT
+
       - name: Initialize Browser Library
         run: uv run rfbrowser init chromium
 
@@ -47,30 +54,56 @@ jobs:
         with:
           script: |
             const fs = require('fs');
-            let output = '';
+
+            // Read test output
+            let testOutput = '';
             try {
-              output = fs.readFileSync('test-output.txt', 'utf8');
+              testOutput = fs.readFileSync('test-output.txt', 'utf8');
             } catch (e) {
-              output = 'Could not read test output.';
+              testOutput = 'Could not read test output.';
             }
+            const testLines = testOutput.trim().split('\n');
+            const testSummary = testLines.slice(-10).join('\n');
 
-            // Extract summary line (last few lines of robot output)
-            const lines = output.trim().split('\n');
-            const summaryLines = lines.slice(-10).join('\n');
+            // Read robocop output
+            let robocopOutput = '';
+            try {
+              robocopOutput = fs.readFileSync('robocop-output.txt', 'utf8').trim();
+            } catch (e) {
+              robocopOutput = 'Could not read Robocop output.';
+            }
+
+            const testPassed = '${{ steps.tests.outcome }}' === 'success';
+            const robocopPassed = '${{ steps.robocop.outcome }}' === 'success';
+
+            const testIcon = testPassed ? '✅' : '❌';
+            const testStatus = testPassed ? 'All tests passed!' : 'Some tests failed.';
 
-            const passed = '${{ steps.tests.outcome }}' === 'success';
-            const icon = passed ? '✅' : '❌';
-            const status = passed ? 'All tests passed!' : 'Some tests failed.';
+            const robocopIcon = robocopPassed ? '✅' : '⚠️';
+            const robocopStatus = robocopPassed ? 'No issues found.' : 'Issues found — see details below.';
 
-            const body = `## ${icon} Robot Framework Test Results
+            const body = `## ${testIcon} Robot Framework Test Results
 
-            **Status:** ${status}
+            **Status:** ${testStatus}
 
             <details>
             <summary>Test Output (last 10 lines)</summary>
 
             \`\`\`
-            ${summaryLines}
+            ${testSummary}
+            \`\`\`
+
+            </details>
+
+            ## ${robocopIcon} Robocop Code Quality
+
+            **Status:** ${robocopStatus}
+
+            <details>
+            <summary>Robocop Output</summary>
+
+            \`\`\`
+            ${robocopOutput}
             \`\`\`
 
             </details>
@@ -91,3 +124,10 @@ jobs:
         with:
           name: pr-robot-results
           path: results/
+
+      - name: Upload Robocop report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: pr-robocop-report
+          path: robocop-output.txt

.github/workflows/robot-tests.yml

@@ -6,6 +6,30 @@ on:
     branches: [main]
 
 jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: uv sync --locked
+
+      - name: Run Robocop lint
+        run: uv run robocop check --output robocop-output.txt tests/ resources/
+
+      - name: Upload Robocop report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: robocop-report
+          path: robocop-output.txt
+
   robot-tests:
     runs-on: ubuntu-latest
     steps:

.gitignore

@@ -21,3 +21,10 @@ Thumbs.db
 # Browser Library runtime
 browser/
 playwright-log.txt
+
+# MkDocs
+site/
+
+# Robocop
+robocop.json
+.robocop_cache/

README.md

@@ -48,14 +48,15 @@ This workshop focuses on **web testing** using Browser Library against [SauceDem
 
 ## Documentation
 
-- [Getting Started](docs/01-getting-started.md) — setup guide (Codespaces, local, Windows)
-- [RF Syntax Cheatsheet](docs/02-rf-syntax-cheatsheet.md) — quick reference
-- [Browser Library Guide](docs/03-browser-library-guide.md) — Browser Library keywords
-- [Exercises](docs/04-exercises.md) — progressive hands-on exercises
-- [Troubleshooting](docs/05-troubleshooting.md) — common issues and fixes
-- [AI-Assisted Testing](docs/06-ai-assisted-testing.md) — using AI for test generation
-- [Student Workflow](docs/07-student-workflow.md) — fork, write tests, submit PR
+- [Getting Started](docs/getting-started.md) — setup guide (Codespaces, local, Windows)
+- [RF Syntax Cheatsheet](docs/rf-syntax-cheatsheet.md) — quick reference
+- [Browser Library Guide](docs/browser-library-guide.md) — Browser Library keywords
+- [Exercises](docs/exercises.md) — progressive hands-on exercises
+- [Troubleshooting](docs/troubleshooting.md) — common issues and fixes
+- [AI-Assisted Testing](docs/ai-assisted-testing.md) — using AI for test generation
+- [Student Workflow](docs/student-workflow.md) — fork, write tests, submit PR
 - [Windows Setup](docs/windows-setup.md) — detailed Windows instructions
+- **[Full Documentation Site](https://hackxit.github.io/42vienna-robotframework-workshop/)** — hosted on GitHub Pages
 
 ## Common Commands
 

docs/06-ai-assisted-testing.md docs/ai-assisted-testing.mddocs/06-ai-assisted-testing.md renamed to docs/ai-assisted-testing.md

@@ -103,7 +103,7 @@ This is the **page object pattern** in action — abstracting complex flows into
    - Locked user → should show locked message
    - Empty username → should show required error
 
-Study the `[Template]` section in `docs/02-rf-syntax-cheatsheet.md`.
+Study the `[Template]` section in the [RF Syntax Cheatsheet](rf-syntax-cheatsheet.md).
 
 ## Exercise 8: AI-Assisted Testing (Demo)
 

docs/03-browser-library-guide.md docs/browser-library-guide.mddocs/03-browser-library-guide.md renamed to docs/browser-library-guide.md

@@ -0,0 +1,85 @@
+# Robot Framework E2E Testing Workshop — 42 Vienna
+
+[![Robot Framework Tests](https://github.com/HackXIt/42vienna-robotframework-workshop/actions/workflows/robot-tests.yml/badge.svg)](https://github.com/HackXIt/42vienna-robotframework-workshop/actions/workflows/robot-tests.yml)
+
+**Part 2: Browser Library & Playwright for Web Testing**
+
+Workshop Date: March 16, 2026, 16:00 — 42 Vienna, Muthgasse 24-26, 1190 Vienna
+
+## Quick Start (3 steps)
+
+1. **Fork** this repository (click "Fork" on GitHub)
+2. **Open a Codespace** on your fork: Code → Codespaces → Create codespace on main
+3. **Run the first test:**
+   ```bash
+   uv run robot tests/00_setup_verification/
+   ```
+
+That's it! If the test passes, your environment is ready.
+
+## What is Robot Framework?
+
+Robot Framework is a **generic** test automation framework. Unlike specialized tools (Cypress for web only, Postman for API only), Robot Framework uses **one syntax** and **one reporting format** across different testing domains:
+
+- **Web testing** → Browser Library (Playwright) or SeleniumLibrary
+- **API testing** → RequestsLibrary or RESTinstance
+- **Mobile testing** → AppiumLibrary
+- **Desktop testing** → Various libraries
+
+This workshop focuses on **web testing** using Browser Library against [SauceDemo](https://www.saucedemo.com).
+
+## Prerequisites
+
+- A **GitHub account** (that's it — we use Codespaces)
+- Optionally: local setup with Python 3.12+, Node.js 22+, and uv
+
+## Workshop Agenda
+
+| Time  | Activity |
+|-------|----------|
+| 16:00 | Welcome, intro, environment setup |
+| 16:30 | RF syntax walkthrough + Browser Library basics |
+| 17:05 | Break |
+| 17:15 | Guided exercises: Login & Product tests |
+| 18:15 | Break |
+| 18:25 | Resource files, keyword abstraction, free exercises |
+| 19:15 | AI-assisted testing demo |
+| 19:30 | PR creation, CI results, wrap-up |
+
+## Documentation
+
+- [Getting Started](getting-started.md) — setup guide (Codespaces, local, Windows)
+- [RF Syntax Cheatsheet](rf-syntax-cheatsheet.md) — quick reference
+- [Browser Library Guide](browser-library-guide.md) — Browser Library keywords
+- [Exercises](exercises.md) — progressive hands-on exercises
+- [Troubleshooting](troubleshooting.md) — common issues and fixes
+- [AI-Assisted Testing](ai-assisted-testing.md) — using AI for test generation
+- [Student Workflow](student-workflow.md) — fork, write tests, submit PR
+- [Windows Setup](windows-setup.md) — detailed Windows instructions
+- [Keyword Documentation](keywords/index.md) — auto-generated keyword reference
+
+## Common Commands
+
+```bash
+# Verify environment
+python scripts/check_environment.py
+
+# Install dependencies
+uv sync
+
+# Initialize browsers
+uv run rfbrowser init chromium
+
+# Run all tests
+uv run robot tests/
+
+# Run specific suite
+uv run robot tests/02_login_tests/
+
+# Run your exercises
+uv run robot tests/student_exercises/yourname_*.robot
+```
+
+## License
+
+[MIT](https://github.com/HackXIt/42vienna-robotframework-workshop/blob/main/LICENSE) — Nikolaus Rieder, 2026