opencode
3de59ccaaf
Build & Push Docker Image / build (push) Successful in 2m33s
- translate remaining pages/components (admin, analytics, redundancy, trash, compare, browse, watchlist, admin tools tab, category combobox, theme toggle, tool preview card, tool-new/edit) to t() calls - locales: 453 keys each, parity verified - docs: bilingual handbook + release notes via *.en.md variants, language-aware docs.tsx (markdown paths, nav titles, search index), LanguageSwitcher in docs header - generate-docs: emit per-locale handbook/release/search output, localized index.json fields (fileEn/titleEn), en-aware snapshots
54 lines
1.8 KiB
Markdown
54 lines
1.8 KiB
Markdown
|
||
# Getting Started
|
||
|
||
This page guides you through the most important workflows in toolr — from your
|
||
first visit to creating and rating a tool.
|
||
|
||
## 1. Sign in
|
||
|
||
Most actions (create a tool, rate, watchlist, compare) require
|
||
an account. Click **Sign in** in the bottom left corner. Depending on the
|
||
instance configuration you have two options:
|
||
|
||
- **Local accounts:** username + password. Access is created by an admin
|
||
(see [Administration](/docs/handbook/administration)).
|
||
- **OIDC (SSO):** sign in with the configured identity provider (e.g.
|
||
Keycloak).
|
||
|
||
Which mode is active is shown by the
|
||
[`GET /auth/mode`](/docs/reference/endpoints/auth#getAuthMode) endpoint. Details
|
||
can be found in the [Sign in & account](/docs/handbook/konto) section.
|
||
|
||
## 2. Find tools
|
||
|
||
Open the **Browse tools** section:
|
||
|
||
- **Search** — full-text search across name & description (shortcut `/`).
|
||
- **Filter** — by category, tags, features and minimum rating
|
||
(`minRating`).
|
||
- **Sort** — by newest, top-rated, most rated, name
|
||
(ascending/descending) or last update.
|
||
|
||
All options in detail: [Find & browse tools](/docs/handbook/tools-finden).
|
||
|
||
## 3. Create a tool
|
||
|
||
Go to **Add tool** and fill in the form. Details for each field can be found
|
||
in the [Create a tool](/docs/handbook/tool-anlegen) section and in the
|
||
[field reference](/docs/reference/schemas/toolinput).
|
||
|
||
## 4. Rate
|
||
|
||
On the detail page of a tool you can submit **usefulness** and **usability**
|
||
(1–5 each) and optionally leave a comment. Your
|
||
rating is immediately reflected in the statistics.
|
||
See [Rating](/docs/handbook/bewerten).
|
||
|
||
## 5. Further reading
|
||
|
||
- [Compare tools](/docs/handbook/vergleichen)
|
||
- [Watchlist](/docs/handbook/watchlist)
|
||
- [Analytics](/docs/handbook/analytics)
|
||
- [Plans & permissions](/docs/handbook/plaene)
|
||
- [Administration](/docs/handbook/administration)
|