Terence Eden zahlte Fremden 150 €, damit sie seine README zerpflücken
I paid people to try and follow my README
Entwickler dokumentieren schlecht, doch die eigene Betriebsblindheit lässt sich kaum überwinden. Terence Eden bezahlte für sein ActivityBot-Projekt fünf Testpersonen je 25 €, damit sie laut denkend die Installation durchspielten. Die Rückmeldungen waren ernüchternd: falscher Demo-Link, unklare Dateinamen, verwirrende Reihenfolge, unverständliche Fachbegriffe – und seine Witze zündeten nicht. Nach jeder Sitzung besserte er nach. Sein Fazit: Echte Menschen sind durch nichts zu ersetzen.
Ich habe insgesamt rund 150 € dafür ausgegeben, dass eine Gruppe von Leuten mich direkt ins Gesicht kritisiert. Hey, billiger als Therapie, oder?
- piro0919
Ich stimme halb zu.
Ich baue Apps mit Claude Code und teste sie, indem ich die KI mit Playwright durch die UI klicken lasse. Das reicht, um zu prüfen, dass die Dinge wie spezifiziert funktionieren und nichts kaputt ist.
Aber ich denke, der Zweck ist ein anderer, wenn eine KI es versucht und wenn ein Mensch es versucht. Extrem ausgedrückt: KI ist für UI und Menschen sind für UX. Menschen finden allerdings auch UI-Probleme: In meinem Musikplayer wurden Songs daran gehindert, in Safari auf einem echten iPad abzuspielen, und ich habe es nur gefunden, indem ich es selbst benutzt habe. Die Dinge, die in diesem Artikel gefunden wurden, wie die Witze, die nicht zündeten, oder nicht zu wissen, was das Tool überhaupt macht, sind auf der Seite, die nur Menschen finden können.
(Ich habe das auf Japanisch geschrieben und KI zum Übersetzen benutzt.)
- bambax
> Aber es ist wirklich schwer, die eigenen Vorurteile zu ignorieren. Natürlich weiß man, dass bestimmte Befehle sudo erfordern, und offensichtlich meinte man mit -foo --foo, und jeder weiß, dass man danach neu starten muss.
Ich schreibe manchmal Readmes für mich selbst, damit ich mich an die genauen Schritte erinnern kann, um einen Datenbericht zu erstellen, usw.
Es ist erstaunlich, wie unverständlich sie schon nach ein paar Wochen werden; wenn alles in unserem Kopf ist, ist es klar, flüssig und selbsterklärend; aber sobald wir den Kontext vergessen haben, ergibt nichts mehr Sinn.
- andai
>Ich hatte tatsächlich nicht erklärt, was die Software tun würde.
Die Hälfte der Beiträge, die ich in letzter Zeit sehe, sind wie: „Gleam 2.0. Was wir gelernt haben“ und dann gehst du auf die Homepage und es heißt: „Gleam ist ein Tribble für deine Fork! (Runterscrollen) Finde heraus, ob du dich für Gleam Enterprise qualifizierst!“
- bryanhogan
Das ist sehr nah an dem, was man im Bereich UX-Design Usability-Testing nennt.
Die Nielson Norman Group hat eine gute Einführung dazu: https://www.nngroup.com/articles/usability-testing-101/
Ist das für die Leute auf HN interessant?
Ich habe einen Studiengang gemacht, der eine Mischung aus Coding und Design war.
- extralongdivisi
> Ich hatte tatsächlich nicht erklärt, was die Software tun würde.
Ich kann dir nicht sagen, wie viele READMEs ich gelesen habe, die dem Muster folgen: „<nichtssagender-name> ist ein <buzzword> <buzzword>, geschrieben in <sprache>.“ Ich habe nur eine vage Vorstellung davon, was es tut, nachdem ich eine Demo benutzt/gesehen habe; zu oft eine, die nicht über die README verfügbar ist.
- legacynl
Ich liebe das. Die meisten Readmes sind einfach schlecht. Ich denke, das Schlimmste ist, wenn eine Readme nicht angibt, was das Projekt macht. Ich verstehe, dass nicht jedes Projekt auf die Öffentlichkeit abzielt, aber wenn man sich schon die Mühe macht, eine Readme-Datei zu erstellen, warum dann nicht die extra 10 Zentimeter gehen und die grundlegendsten Informationen schreiben?
Weitere Probleme:
* veraltete (und damit falsche) Informationen
* Verwendung nicht eingeführter Abkürzungen (Bonuspunkte für Abkürzungen, die gängige Bedeutungen haben, z. B.: EG, NB, IE, ETC)
- trollbridge
Das ist eines dieser Dinge, in denen LLMs wirklich gut sind.
Erstelle einen neuen Container oder eine Sandbox, kopiere das Git-Repo hinein oder richte es auf deine Staging-Dokumente aus und schau, was passiert.
- pinkmuffinere
> Meine Witze sind nicht lustig und aktiv verwirrend.
:’)