Link the handbook from the app #142

Closed
opened 2026-11-06 09:59:57 +01:00 by miko · 1 comment
Owner

Part of #137
Depends on #138 (the URL must be live).

What

Link the handbook from the app.

Decisions (from the #137 grilling)

  • A "Help" entry in the UserMenu (src/components/UserMenu.tsx), linking to the User handbook. Visible to every signed-in user.
  • In the admin area, a link to the Administration handbook.
  • No link for guests: reading should be self-explanatory, and the public site belongs to the organisation, not to kataba.
  • The handbook URL (https://pages.mike-ochmann.de/kataba/) is a constant in the code, not an environment variable.
  • Links open in a new tab. Labels are translated (en/de catalogs).
  • Context-sensitive help links (e.g. a "?" in the editor jumping to the annotations page) are out of scope — a later ticket.

Acceptance criteria

  • Signed-in users see "Help" in the user menu, opening the user handbook
  • Admins find a link to the administration handbook in the admin area
  • Guests see neither
  • Tests cover the visibility per role
Part of #137 Depends on #138 (the URL must be live). ## What Link the handbook from the app. ## Decisions (from the #137 grilling) - A **"Help"** entry in the `UserMenu` (`src/components/UserMenu.tsx`), linking to the **User handbook**. Visible to every signed-in user. - In the **admin area**, a link to the **Administration handbook**. - **No link for guests**: reading should be self-explanatory, and the public site belongs to the organisation, not to kataba. - The handbook URL (`https://pages.mike-ochmann.de/kataba/`) is a **constant in the code**, not an environment variable. - Links open in a new tab. Labels are translated (en/de catalogs). - Context-sensitive help links (e.g. a "?" in the editor jumping to the annotations page) are **out of scope** — a later ticket. ## Acceptance criteria - [ ] Signed-in users see "Help" in the user menu, opening the user handbook - [ ] Admins find a link to the administration handbook in the admin area - [ ] Guests see neither - [ ] Tests cover the visibility per role
Author
Owner

Implemented in #147: Help in the user menu (user handbook), Administration handbook in the admin menu, nothing for guests; per-role e2e tests in e2e/titlebar.spec.ts.

Implemented in #147: Help in the user menu (user handbook), Administration handbook in the admin menu, nothing for guests; per-role e2e tests in e2e/titlebar.spec.ts.
miko closed this issue 2026-11-06 11:54:24 +01:00
Sign in to join this conversation.
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
MassiveDynamic/kataba#142
No description provided.