Hallo Thomas,
» Ich frage mich, warum manche hier verlangen, dass man erst einmal selbst großartig auf die Nase fallen soll. Es gibt doch nichts besseres als ein Einstieg auf hohem Niveau.
Ja und nein.
:-)
In der Praxis schaut das leider so aus, dass die Frameworks und Bibliotheken zwar "alles" können, aber die Dokumentation ist entweder so vorhanden, dass man sie als "nichtvorhanden" bezeichnen kann, oder es ist nur eine reine API-Doku, die zwar "nett", aber für das Einlernen in das Arbeiten mit dem Framwork nutzlos ist.
ja, reine API-Doku ist kaum besser als gar keine Dokumentation. Sie dient leider oft genug als Feigenblatt: "Ist doch dokumentiert", "Ist doch kommentiert", ... und leider nur für den zu gebrauchen, der sich in der Materie so gut auskennt, dass er keine Doku benötigt.
Aus genau diesem Grund sind *für mich* manche Postings mit funktionierendem Code (geniale Ein- oder Zweizeiler, die genau das Problem lösen) völlig unbrauchbar, weil ich's nicht oder nur mit unverhältnismäßig großem Aufwand. nachvollziehen kann. Je kürzer der Code, um so umfangreicher sollte der Kommentar ausfallen - und das gilt meiner Erfahrung nach auch für Produktivcode.
Freundliche Grüße
Vinzenz