diff --git a/src/pages/de/concepts/configuration/index.mdx b/src/pages/de/concepts/configuration/index.mdx
index c1f043189fdbc1beab50e1d6e3fcfd0f8f3146ae..3878787eff641109eadfdc76e5af4af1d24d3f7c 100644
--- a/src/pages/de/concepts/configuration/index.mdx
+++ b/src/pages/de/concepts/configuration/index.mdx
@@ -6,24 +6,23 @@ import { Callout } from 'nextra/components'
# Konfigurationsdatei
<Callout type="info">
- Die Konfigurationsdatei der offiziellen Instanz finden Sie [hier →](https://gitlab.opencode.de/open-code/badgebackend/badge-config/-/blob/main/.badge-api.yaml?ref_type=heads)
+ Die Konfigurationsdatei der offiziellen Instanz finden Sie [hier →](https://gitlab.opencode.de/open-code/badgebackend/badge-config/-/blob/main/.badge-api.yaml)
</Callout>
+Die Badge-API wird mithilfe einer yaml-Konfigurationsdatei mit dem Namen `.badge-api.yaml` konfiguriert. Das Programm sucht diese Datei im aktuellen Arbeitsverzeichnis
+und in `/etc/badge-api/` oder frag diese aus einem Git-Repository ab.
+Die Konfigurationsdatei besteht aus mehreren Schlüsselabschnitten, darunter:
-The badge API is configured using a yaml configuration file with the name `.badge-api.yaml`. The program looks for this file in the current working directory and inside `/etc/badge-api/`.
+- **gitClients**: Enthält die Konfiguration für die Verbindung zu Git-Anbietern.
+- **badges**: Definiert die Abzeichen, ihre Stufen, Prüfungen und zugehörigen Schwellenwerte.
+- **personalEmailDomains**: Eine Liste persönlicher E-Mail-Domains (erforderlich für die Überprüfung des Elefanten- und Busfaktors).
+- **remoteConfigUrl**: URL zu einer Remote-Konfigurationsdatei (optional). Oder die Umgebungsvariable `REMOTE_CONFIG_URL`.
+- **subsequentUseApiDomain**: Die Domain der API für die nachfolgende Verwendung
-The configuration file consists of several key sections, including:
+### Git Clients Konfiguration
-- **gitClients**: Contains the configuration for connecting to git providers.
-- **badges**: Defines the badges, their levels, checks, and associated thresholds.
-- **personalEmailDomains**: A list of personal email domains (required by the elephant and bus factor check).
-- **remoteConfigUrl**: URL to a remote configuration file (optional). Or `REMOTE_CONFIG_URL` environment variable.
-- **subsequentUseApiDomain**: The domain of the subsequent use API
-
-### Git Clients Configuration
-
-The `gitClients` section defines how the Badge API connects to GitLab repositories.
+Der Abschnitt `gitClients` definiert, wie die Badge-API eine Verbindung zu GitLab-Repositorys herstellt.
```yaml
gitClients:
@@ -33,25 +32,30 @@ gitClients:
maxRequestsPerSecond: <requests_per_second>
```
-- `baseUrl`: The URL of your GitLab instance (e.g., https://gitlab.opencode.de).
+- `baseUrl`: Die URL Ihrer GitLab-Instanz (z. B., https://gitlab.opencode.de).
- `tokenFile`: The file containing the access token (see Token Permissions).
- `type`: The type of GitLab server (e.g., gitlab).
- `maxRequestsPerSecond`: Maximum number of requests allowed per second to avoid rate-limiting.
-#### Token Permissions
-
-The token is used to authenticate the badge API against the git provider API. For regular usage the token does not need any special permissions. It is only used because even for open source projects **gitlab** requires authentication for `/member` endpoints.
-
-Nevertheless, there is a special case if you provide [manual checks](#manual-check-type) with a decision json file stored in a private repository. In this case, the badge api uses the provided token to access the json file as well (if the baseURL matches). For this operation the token needs to have at least the `read_repository` permission (project access token is fine as well). The same applies to `svgUrls` which are stored in private repositories.
+#### Token Rechte
+Ein Token wird verwendet, um die Badge-API gegenüber der API des Git-Providers zu authentifizieren. Für den regulären Gebrauch
+benötigt der Token keine besonderen Berechtigungen. Er wird nur verwendet, weil **GitLab** selbst für
+Open-Source-Projekte eine Authentifizierung für den Endpunkt `/member` erfordert.
-The API identifies the correct token by the provided `baseUrl` and `type` in the configuration file.
+Es gibt jedoch einen Sonderfall, wenn Sie [manuelle Prüfungen](/de/concepts/configuration/manual-checks) mit einer in einem privaten Repository
+gespeicherten Entscheidungs-JSON-Datei bereitstellen. In diesem Fall verwendet die Badge-API das bereitgestellte Token
+auch für den Zugriff auf die JSON-Datei (sofern die baseURL übereinstimmt). Für diesen Vorgang muss das Token mindestens
+über die Berechtigung `read_repository` verfügen (ein Projektzugriffstoken ist ebenfalls zulässig). Dasselbe gilt für
+`svgUrls`, die in privaten Repositorys gespeichert sind.
+Die API identifiziert das richtige Token anhand der bereitgestellten `baseUrl` und `type` in der Konfigurationsdatei.
-### Badges Configuration
+### Badges Konfiguration
-The `badges` section defines various badges, their levels, and checks. A badge can have multiple levels, each with associated checks.
+Im Abschnitt `badges` werden verschiedene Badges, ihre Level und Prüfungen definiert. Eine Badge
+kann mehrere Stufen haben, die jeweils mit Prüfungen verbunden sind.
```yaml
badges:
@@ -68,24 +72,17 @@ badges:
min: <minimum_value>
max: <maximum_value>
```
+Jede Badge kann verschiedene Stufen haben (z. B. `bronze`, `silver`, `gold`). Für jede Stufe gibt es
+Prüfungen, die auf das Projekt angewendet werden. Die verfügbaren Prüfungen finden Sie im Abschnitt
+[Implemnetierte Checks](/de/concepts/implemented-checks).
-Each badge can have different levels (e.g., `bronze`, `silver`, `gold`). For each level, there are checks that are applied to the project. A check can be based on the following types:
+Jeder Check hat einen Schwellenwert mit zwei optionalen Parametern:
-- `COMMITS`: Checks if the project has a minimum number of commits in a defined time range.
-- `ISSUE_REACTION_TIME`: Measures the average time to respond to issues.
-- `BUS_FACTOR`: Checks the number of maintainers involved.
-- `RELEASES`: Checks the number of releases made in a specified period.
-- `ELEPHANT_FACTOR`: Checks if multiple companies are contributing to the project.
-- `PACKAGES`: Checks the number of packages released.
-- `CI_PIPELINES`: Checks the number of successful CI pipelines.
+- `min`: Mindestwert (z. B. Anzahl der Commits, Maintainer).
+- `max`: Maximalwert (z. B. Antwortzeit auf Issues).
+- `timeRangeInMonths`: Zeitraum (in Monaten) zur Bewertung der Projektaktivität.
-Each check has a threshold with two optional parameters:
-
-- `min`: Minimum value required (e.g., number of commits, maintainers).
-- `max`: Maximum value allowed (e.g., issue response time).
-- `timeRangeInMonths`: Time period (in months) to evaluate the project activity.
-
-### Example configuration
+#### Beispiel Konfiguration
```yaml
badges:
@@ -129,54 +126,12 @@ badges:
min: 1
```
-### Manual check type
-
-Besides the predefined checks there is a `MANUAL` check type. This type of check requires external input or decision-making, which cannot be automatically evaluated by the API based on predefined metrics like commits, issues, or releases. Instead, it relies on an external JSON file to guide the decision-making process.
-
-Example of a manual check:
-
-```yaml
-badges:
- - id: open-source
- description: This badge checks if a project is open source.
- levels:
- - name: gold
- svgUrl: https://gitlab.opencode.de/open-code/badgebackend/manual-badges/-/raw/main/badges/open-source.svg
- checks:
- - type: MANUAL
- decisionJsonUrl: https://gitlab.opencode.de/open-code/badgebackend/manual-badges/-/raw/main/badges/open-source.json
- description: Checks if a project is open source. This check is decided manually by the openCode team.
-```
-
-In this case, the decisionJsonUrl points to a file (open-source.json) that contains the rules or decision criteria for determining if a project is open source. The file is hosted on a GitLab server, and the Badge API will refresh it every 5 minutes.
-
-The JSON file should have the following structure:
-
-```json
-{
- "granted": <List of repository urls that are granted the badge>,
- "grantedRegex": <List of regex patterns that are granted the badge>,
-}
-```
-
-Example decision JSON file:
-
-```json
-{
- "granted": [
- "https://gitlab.opencode.de/open-code/badgebackend/badge-api",
- "https://gitlab.opencode.de/open-code/badgebackend/badge-frontend"
- ],
- "grantedRegex": [
- "https://gitlab.opencode.de/open-code/badgebackend/.*"
- ]
-}
-```
-
-
-### Remote Configuration
-
-The `remoteConfigUrl` parameter allows you to specify a URL to a remote configuration file. This file will be fetched and used to override the local configuration. Only the `badges` and `personalEmailDomains` sections are respected from the remote configuration file. To update other values, a local file needs to be used.
-
-The remote configuration file might contain the special string `<badge-config-repo>`. This value will be replaced with the `remoteConfigUrl` base path. This is useful to validate remote configuration from a different branch and pass the url via an environment variable.
+### Remote-Konfiguration
+Mit dem Parameter `remoteConfigUrl` können Sie eine URL zu einer Remote-Konfigurationsdatei angeben. Diese
+Datei wird abgerufen und verwendet, um die lokale Konfiguration zu überschreiben. Nur die Abschnitte
+`badges` und `personalEmailDomains` werden aus der Remote-Konfigurationsdatei berücksichtigt. Um andere
+Werte zu aktualisieren, muss eine lokale Datei verwendet werden.
+Die Remote-Konfigurationsdatei kann die spezielle Zeichenfolge `<badge-config-repo>` enthalten. Dieser
+Wert wird durch den `remoteConfigUrl`-Basispfad ersetzt. Dies ist nützlich, um die Remote-Konfiguration
+von einem anderen Branch aus zu validieren und die URL über eine Umgebungsvariable zu übergeben.
diff --git a/src/pages/de/concepts/configuration/manual-checks.mdx b/src/pages/de/concepts/configuration/manual-checks.mdx
index 00aadff4e12704be1354967dd657654178d37300..7f2d99e85d362108a48e397f3e80ec1a49ad8f15 100644
--- a/src/pages/de/concepts/configuration/manual-checks.mdx
+++ b/src/pages/de/concepts/configuration/manual-checks.mdx
@@ -1,14 +1,15 @@
{/* Copyright 2025 Zentrum für Digitale Souveränität der Öffentlichen Verwaltung (ZenDiS) GmbH.
SPDX-License-Identifier: MIT */}
-# Manual checks
+# Manuelle checks
-Manual checks are a special type of check that is not automatically evaluated by the badge API.
-Instead, the result of the check is provided by a JSON file that is hosted on a server reachable by the Badge API Instance.
-The JSON file contains a list of granted projects or a regex pattern for granted projects.
+Manuelle Prüfungen sind eine besondere Art von Prüfung, die nicht automatisch von der Badge-API ausgewertet wird.
+Stattdessen wird das Ergebnis der Prüfung von einer JSON-Datei bereitgestellt, die auf einem Server gehostet wird,
+der von der Badge-API-Instanz aus erreichbar ist.
+Die JSON-Datei enthält eine Liste der genehmigten Projekte oder ein Regex-Muster für genehmigte Projekte.
-You can provide a GitLab personal access token via the environment variable `GITLAB_TOKEN` to access a private repository
-where the JSON file is stored.
+Sie können einen persönlichen GitLab-Zugriffstoken über die Umgebungsvariable `GITLAB_TOKEN` bereitstellen,
+um auf ein privates Repository zuzugreifen, in dem die JSON-Datei gespeichert ist.
```json filename="manual-check.json" copy
{
@@ -19,5 +20,5 @@ where the JSON file is stored.
}
```
-The file is referenced in the `.badge-api.yaml` configuration file of the badge.
-See more details about the [configuration file](/en/concepts/configuration).
\ No newline at end of file
+Die Datei wird in der Konfigurationsdatei `.badge-api.yaml` des Badges referenziert.
+Weitere Informationen zur Konfigurationsdatei finden Sie [hier](/de/concepts/configuration).
\ No newline at end of file