docs: align with canonical product-pages structure (#77)

* chore(openspec): add docs-product-pages-conformance change artifacts

* docs: align with canonical product-pages structure

- Create canonical folders: Features/, Technical/, UseCases/, Integrations/
- Rename tutorials/ to user-guide/ (11 files + screenshots)
- Move 7 root MDs to canonical locations (FEATURES, ARCHITECTURE, etc.)
- Create installation.md with App Store + manual install steps
- Create UseCases/index.md + Integrations/index.md stubs (#73)
- Em-dash sweep: 0 remaining across all docs files (closes #76)
- Fix internal links in intro.md to new canonical paths
- Add redocusaurus@^2.0.0 to package.json; mount at /api (/api) (#75)
- Create static/oas/scholiq.json placeholder OAS 3.0.3 stub
- Add API Documentation navbar link
- Scaffold i18n/nl/ directory tree for Dutch translation (#74)
- NL locale escape hatch applied: SSR race on Docusaurus 3.9.2;
  reverted to en-only with TODO #74 comment

Author: rubenvdlinde

docs/FEATURES.md docs/Features/features.mddocs/FEATURES.md renamed to docs/Features/features.md

@@ -0,0 +1,19 @@
+---
+sidebar_position: 1
+draft: true
+---
+
+# Integrations
+
+This section is under construction. Integration guides for Scholiq are being authored in [GitHub issue #73](https://github.com/ConductionNL/scholiq/issues/73).
+
+Planned integrations include:
+
+- **OpenRegister**: data layer (required)
+- **OpenConnector**: BRON/ROD, UWLR, OSO, Edukoppeling, Studielink, Digikoppeling adapters (required)
+- **MyDash**: student and credential analytics surfaces (recommended)
+- **DocuDesk**: diploma and certificate document templating (optional)
+- **SURFconext**: SSO federation for higher education
+- **DUO BRON/ROD**: student registration exchange
+
+Follow [#73](https://github.com/ConductionNL/scholiq/issues/73) for progress.

docs/Integrations/index.md

@@ -1,4 +1,4 @@
-# Scholiq — Admin Guide
+# Scholiq, Admin Guide
 
 This guide covers installation, register bootstrapping, signing key configuration, and troubleshooting for Nextcloud administrators.
 
@@ -31,14 +31,14 @@ Or via the Nextcloud App Store: search for **Scholiq**, click **Download and ena
 
 Auto-bootstrap of the register on `app:enable` is blocked by openregister#1487, tracked in scholiq#35. Until that is resolved, you must import the register manually after every fresh install.
 
-**Option A — OCC command:**
+**Option A, OCC command:**
 
 ```bash
 docker exec nextcloud php occ openregister:register:import \
   /var/www/html/custom_apps/scholiq/lib/Settings/scholiq_register.json
 ```
 
-**Option B — OpenRegister admin UI:**
+**Option B, OpenRegister admin UI:**
 
 1. Open Nextcloud as admin.
 2. Go to **OpenRegister** > **Registers** > **Import**.
@@ -49,16 +49,16 @@ docker exec nextcloud php occ openregister:register:import \
 
 Open **OpenRegister** > **Schemas** and confirm you see all 9 scholiq schemas listed.
 
-If any are missing, re-run the import. If the import fails, check the OpenRegister version — scholiq requires `openregister ^v0.2.10`.
+If any are missing, re-run the import. If the import fails, check the OpenRegister version, scholiq requires `openregister ^v0.2.10`.
 
 ---
 
 ## Configure tenant signing keys
 
 Scholiq uses RSA key pairs for two purposes:
 
-- **Credential signing** — `CredentialSigningService` RS256-signs Open Badges 3.0 assertions.
-- **Attestation HMAC** — `AttestationSigningGuard` uses the tenant key for HMAC-SHA256.
+- **Credential signing**, `CredentialSigningService` RS256-signs Open Badges 3.0 assertions.
+- **Attestation HMAC**, `AttestationSigningGuard` uses the tenant key for HMAC-SHA256.
 
 Keys are stored via Nextcloud's `ICrypto` interface (encrypted at rest).
 
@@ -78,7 +78,7 @@ This generates a new RSA-2048 key pair and stores it in `IAppConfig` under the `
 
 ### Rotate keys
 
-Key rotation does not invalidate existing signatures — each signed object stores the `signingKeyId` used at signing time.
+Key rotation does not invalidate existing signatures, each signed object stores the `signingKeyId` used at signing time.
 
 ```bash
 docker exec nextcloud php occ scholiq:keys:generate --rotate
@@ -143,17 +143,17 @@ docker exec nextcloud php occ openregister:register:import \
 
 **Symptom:** Learners do not receive due-date reminders or completion notifications.
 
-**Check 1 — NC cron:** Nextcloud's background job runner must be active. Check:
+**Check 1, NC cron:** Nextcloud's background job runner must be active. Check:
 ```bash
 docker exec nextcloud php occ background-job:run --list
 ```
 
-**Check 2 — OR notification worker:** OpenRegister's notification dispatch depends on its own cron hook. Verify OR's background jobs are not stalled:
+**Check 2, OR notification worker:** OpenRegister's notification dispatch depends on its own cron hook. Verify OR's background jobs are not stalled:
 ```bash
 docker exec nextcloud php occ background-job:run OCA\\OpenRegister\\BackgroundJob\\NotificationJob
 ```
 
-**Check 3 — User preferences:** Notifications are gated by user preference keys (`notify_assignments`, `notify_due_dates`). Check that these are not disabled in the user's Scholiq settings.
+**Check 3, User preferences:** Notifications are gated by user preference keys (`notify_assignments`, `notify_due_dates`). Check that these are not disabled in the user's Scholiq settings.
 
 ### Attestation signing fails
 

docs/ADMIN-GUIDE.md docs/Technical/admin-guide.mddocs/ADMIN-GUIDE.md renamed to docs/Technical/admin-guide.md

@@ -1,9 +1,9 @@
-# Scholiq — API Reference
+# Scholiq, API Reference
 
 Scholiq exposes two categories of API surface:
 
-1. **OpenRegister object API** — all CRUD and lifecycle operations on the 9 schemas go through OR's REST API. Scholiq does not wrap these with its own controllers.
-2. **Scholiq-specific endpoints** — thin PHP controllers for operations OR cannot yet express declaratively: public credential verification, audit-pack ZIP export, admin key management, and health diagnostics.
+1. **OpenRegister object API**, all CRUD and lifecycle operations on the 9 schemas go through OR's REST API. Scholiq does not wrap these with its own controllers.
+2. **Scholiq-specific endpoints**, thin PHP controllers for operations OR cannot yet express declaratively: public credential verification, audit-pack ZIP export, admin key management, and health diagnostics.
 
 Base URL (local dev): `http://localhost:8080/index.php/apps`
 
@@ -19,13 +19,13 @@ Scholiq uses the standard OR objects API. The register slug is `scholiq`.
 GET /openregister/api/objects?register=scholiq&schema={schema-slug}
 ```
 
-**Example — list all published courses:**
+**Example, list all published courses:**
 
 ```
 GET /openregister/api/objects?register=scholiq&schema=course&lifecycle=published
 ```
 
-**Example — list mandatory enrolments for a learner:**
+**Example, list mandatory enrolments for a learner:**
 
 ```
 GET /openregister/api/objects?register=scholiq&schema=enrolment&learnerId=alice&mandatory=true
@@ -78,7 +78,7 @@ Content-Type: application/json
 }
 ```
 
-**Example — publish a course:**
+**Example, publish a course:**
 
 ```
 POST /openregister/api/objects/{course-uuid}/transition
@@ -87,7 +87,7 @@ POST /openregister/api/objects/{course-uuid}/transition
 
 If the `CoursePublishGuard` check fails (no published lessons), the response is `422 Unprocessable Entity` with an error message.
 
-**Example — sign an attestation:**
+**Example, sign an attestation:**
 
 ```
 POST /openregister/api/objects/{attestation-uuid}/transition
@@ -119,7 +119,7 @@ All endpoints below require an authenticated Nextcloud session unless marked `@P
 
 Verifies a credential by ID. Returns validity status and the Open Badges 3.0 payload. Writes a `credential.verified` audit entry via OR.
 
-**Response 200 — valid credential:**
+**Response 200, valid credential:**
 
 ```json
 {
@@ -138,7 +138,7 @@ Verifies a credential by ID. Returns validity status and the Open Badges 3.0 pay
 }
 ```
 
-**Response 200 — revoked credential:**
+**Response 200, revoked credential:**
 
 ```json
 {
@@ -254,8 +254,8 @@ Generates a new RSA key pair and stores it via `ICrypto`. Equivalent to `occ sch
 
 User and admin settings endpoints backed by `SettingsController`.
 
-`GET /scholiq/api/settings` — returns current user's Scholiq preferences.
-`POST /scholiq/api/settings` — updates preferences.
+`GET /scholiq/api/settings`, returns current user's Scholiq preferences.
+`POST /scholiq/api/settings`, updates preferences.
 
 **User preference keys:**