Code ist die Dokumentation selbst – kommt zu Golang~
Wir entwickeln auch ohne README, indem wir den Testcode durchsehen.

 

Früher haben sie schon mit all diesen Kits nur jede Menge völlig überflüssige Gimmicks herausgehauen, als wären sie etwas Großartiges … ganz typisch Apple. Wie ein Huhnerrippchen.

 

Das ist zwar ein etwas anderer Kontext, aber dass die Tutorial-Hölle entsteht, liegt auch daran, dass Framework-Tutorials nicht als grundlegende Lehrmaterialien für Informatik verwendet werden.
Ein Anfänger, der sich das Django-Tutorial angesehen und eine Poll-App gebaut hat, kann nicht allein einen Blog erstellen, weil das Django-Tutorial ein Text ist, der Django für Menschen erklärt, die bereits wissen, was HTTP ist, was Templates sind, was WS ist, was eine DB ist usw. — es ist kein Text, der das Web erklärt. Im Django-Tutorial wird sehr viel Kontext ausgelassen, und ich denke, das ist vielleicht die Ursache dafür, dass die Tutorial-Hölle entsteht.
Es wäre vielleicht auch eine gute Aufgabe, das Django-Tutorial einmal für Menschen neu zu schreiben, die heute zum ersten Mal programmieren. Zum Beispiel so, dass man zuerst die Struktur von HTTP erklärt und dann erläutert, wie Django die einzelnen Elemente handhabt.

 

Ich nutze KT Giga Wi-Fi; der Kanalbandbreite war auf 80 MHz eingestellt, und als ich sie testweise auf 40 MHz umgestellt und die Ergebnisse von networkQuality unter macOS verglichen habe, ist bei mir bei 40 sowohl die Responsiveness als auch die Leistung deutlich eingebrochen.

 

Ich habe aus Neugier ein paar weitere Dinge ausprobiert, weil ich dachte, dass es noch mehr solche Fälle geben könnte. Es ist nicht konsistent, aber manchmal gerät auch der Seestern (Starfish) in eine Schleife. Wenn man es wiederholt ausprobiert, kommen selbst dann, wenn keine Schleife entsteht, zumindest ein paar Mal Antworten heraus, die verwirrt wirken. Man muss allerdings auf Englisch und nicht auf Koreanisch fragen. Vermutlich ist die Kombination aus zwei Wörtern (Star+Fish) und einem Tier, das es als Emoji geben könnte, der Trick dabei, haha.

ChatGPT-Gespräch

 

Ryanair sollte man einfach grundsätzlich meiden … absolut furchtbar..

 

Einstellungen > Bedienungshilfen > Anzeige & Textgröße > Transparenz reduzieren
Einstellungen > Bedienungshilfen > Anzeige & Textgröße > Kontrast erhöhen
Einstellungen > Bedienungshilfen > Anzeige & Textgröße > Ohne Farbe differenzieren

Mit diesen Einstellungen war der Krebs geheilt

 

Ich dachte schon, ich wäre der Einzige, der zu dumm ist, die offizielle Dokumentation zu verstehen, haha.
Wenn man einfach ein echtes Beispiel hinwirft und nur ein bisschen dazu erklärt, versteht man es wirklich schnell ...

 

PHP wäre dann wohl zugleich ein gutes und ein schlechtestes Beispiel.

Es ist ein gutes Beispiel, weil man in der offiziellen Dokumentation von Nutzern beigetragene Inhalte hochladen kann und dadurch viele verschiedene Codebeispiele zu sehen bekommt,

...aber auch das schlechteste Beispiel, weil PHP bei den eingebauten Funktionen viele subtile BCs hat und die beigesteuerten Beispiele alle noch aus Uralt-Versionen stammen, sodass sich Dinge darunter mischen, die sich von der tatsächlichen Funktionsweise leicht unterscheiden und die Verwirrung nur noch vergrößern... haha.. ha...

 

Wenn man sich frühere iOS- oder Cocoa-Entwicklungsdokumentationen ansieht, gab es dort einen eigenen Use-Case-Abschnitt; wäre das nicht die richtige Art der Dokumentation? Beispiele, Funktionssignaturen und Erklärungen zum Verhalten werden alle gebraucht.

 

Ich habe mich erst gefragt, worum es eigentlich geht, lol

 

Dass Beispiele die beste Dokumentation sind.

Wenn früher die Schwächen der offiziellen Docs durch Stack Overflow und Googeln ausgeglichen wurden, scheint das heute von LLMs übernommen zu werden.

 

Wenn ich mir die Kommentare ansehe, gibt es auch Stimmen im Sinne von, dass es früher ebenfalls so gewesen sei, aber ich halte das für eine Ausrede. Ein Speicherleck ist ein Problem, das man eindeutig erkennen kann, wenn man ein Programm auch nur für die minimal nötige Zeit laufen lässt; dass das nicht gemacht wurde, ist schon ziemlich absurd.

 

Ich halte das derzeit noch für harmlos. Wenn nun eine Welt kommt, in der KI sogar direkt mit physischen Aktionen und Finanztransaktionen verbunden ist, könnte das tatsächlich zu einer gewaltigen Katastrophe führen.

 

Ich wünschte, die Stabilität des Explorers in Windows 11 würde etwas verbessert. Es wäre auch schön, wenn das Trennen von Tabs genauso flott wäre wie in Chromium-Browsern..

 

Im Java-Umfeld und in der objektorientierten Kultur gab es besonders viele bedeutungslose Erklärungssätze und formale Dokumentation, und auch in den Python-Frameworks, die diese Atmosphäre übernommen haben, sind Beispiele auffallend dürftig.

Ein Beispiel für sinnlose Dokumentation
add(left, right) - Addiert den linken und den rechten Operanden

Gerade die wirklich wichtigen Dinge wie die Datentypen der Parameter, mögliche Exceptions oder die Form der Rückgabewerte bzw. die Funktionsweise werden dabei nicht erklärt.

Bei Manpages der C-Sprache reicht dagegen oft schon eine kurze Beschreibung, sodass man die Verwendung zumindest anhand des Funktions- und der Parameternamen erschließen kann.

 

Sie sind noch immer nicht ganz zur Vernunft gekommen.
Für NVMe gilt die Richtlinie noch immer..

 
labeldock 2025-10-11 | übergeordneter Kommentar | in: Du benutzt Rails falsch (bananacurvingmachine.com)

Ich liebe beide Tools. Die beiden Tools haben Überschneidungen bei Ökosystem und Einsatzzweck, sind aber keine völlig identischen Werkzeuge und sollten nicht nach ihrem Schwierigkeitsgrad bewertet werden. Mit Vite kann man Skripte umfangreich und fein abgestimmt schreiben. Stimulus oder Hotwire sind hingegen besser dafür geeignet, die Entwicklung von Skripten auf ein Minimum zu reduzieren.