📖 🤖 README prüfen und entwüsten: Anleitung gegen Code, Quickstart, weniger Fließtext #103

Closed
opened 2026-11-02 23:46:45 +01:00 by holm · 1 comment
Owner
Dimension Bewertung Einschätzung
Aufwand ███░░░░░░░ Gering-mittel
Nutzen ███████░░░ Hoch: Einstieg für neue Nutzer, Tenants (#102)
Bruchhäufigkeit █████░░░░░ README driftet bei jedem Feature
Nachhaltigkeit ██████░░░░ Mittel
Dringlichkeit █████░░░░░ Mittel

Auftrag (Holm 2026-11-02)

„Prüfe: Ist das README / die Anleitung noch korrekt? Sonst: Issue, Fix. Mach's außerdem etwas hübscher, weniger Textwüste.“

Umfang

  • Jeden Befehl, Pfad, Schlüssel und jede Abhängigkeit im README gegen den Code prüfen (build.sh, zpub, check.sh, deploy.sh, editor.sh, mastodon-*.sh, legacy/, shell.nix) — Abweichungen fixen.
  • Struktur: Kurzeinstieg oben (Demo, Screenshot, 3-Befehl-Quickstart mit zpub), Details in aufklappbare Abschnitte (<details>) oder nach docs/ auslagern; Tabellen statt Fließtext, wo es geht.

🤖 angelegt von Claude v00 (API/Token holm)

| Dimension | Bewertung | Einschätzung | |---|---|---| | Aufwand | `███░░░░░░░` | Gering-mittel | | Nutzen | `███████░░░` | Hoch: Einstieg für neue Nutzer, Tenants (#102) | | Bruchhäufigkeit | `█████░░░░░` | README driftet bei jedem Feature | | Nachhaltigkeit | `██████░░░░` | Mittel | | Dringlichkeit | `█████░░░░░` | Mittel | ## Auftrag (Holm 2026-11-02) „Prüfe: Ist das README / die Anleitung noch korrekt? Sonst: Issue, Fix. Mach's außerdem etwas hübscher, weniger Textwüste.“ ## Umfang - Jeden Befehl, Pfad, Schlüssel und jede Abhängigkeit im README gegen den Code prüfen (build.sh, zpub, check.sh, deploy.sh, editor.sh, mastodon-*.sh, legacy/, shell.nix) — Abweichungen fixen. - Struktur: Kurzeinstieg oben (Demo, Screenshot, 3-Befehl-Quickstart mit zpub), Details in aufklappbare Abschnitte (`<details>`) oder nach `docs/` auslagern; Tabellen statt Fließtext, wo es geht. > 🤖 angelegt von Claude v00 (API/Token holm)
Author
Owner

Abgenommen und gemergt (acc7a50 auf dev; Worker 9ec52e5 Korrekturen, 4fff546 Umbau). 13 Korrektheitsbefunde gefixt (u. a. deploy.sh-Abhängigkeiten, Cover 1400–3000 px, speaker.toml-Schlüssel, check-Exit-Codes, ⚠ statt ✗ ohne Audio, *.secret.toml, Pfad scripts/parse_episode.sh). README 362 → 196 Zeilen: Demo + Screenshot, Quickstart in 4 Befehlen, Feature-/Doku-/Befehlstabellen, Details eingeklappt; Referenz nach docs/configuration.md, docs/deploy.md, docs/web-editor.md, docs/mastodon.md. Codebefunde: zpub-VERSION → 6c53348; Schlüssel ohne Wirkung → #106. (Hinweis Worker „tag.sh byte-gleich“: ist ein Symlink auf scripts/tag.sh, Mode 120000 — kein Befund.)

🤖 angelegt von Claude v00 (API/Token holm)

Abgenommen und gemergt (acc7a50 auf dev; Worker 9ec52e5 Korrekturen, 4fff546 Umbau). 13 Korrektheitsbefunde gefixt (u. a. deploy.sh-Abhängigkeiten, Cover 1400–3000 px, speaker.toml-Schlüssel, check-Exit-Codes, ⚠ statt ✗ ohne Audio, `*.secret.toml`, Pfad `scripts/parse_episode.sh`). README 362 → 196 Zeilen: Demo + Screenshot, Quickstart in 4 Befehlen, Feature-/Doku-/Befehlstabellen, Details eingeklappt; Referenz nach `docs/configuration.md`, `docs/deploy.md`, `docs/web-editor.md`, `docs/mastodon.md`. Codebefunde: zpub-VERSION → 6c53348; Schlüssel ohne Wirkung → #106. (Hinweis Worker „tag.sh byte-gleich“: ist ein Symlink auf scripts/tag.sh, Mode 120000 — kein Befund.) > 🤖 angelegt von Claude v00 (API/Token holm)
holm closed this issue 2026-11-02 23:54:24 +01:00
Sign in to join this conversation.
No milestone
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
Zentonic/zentonic-publisher#103
No description provided.