while(true) {write();} - Der Programmierer-Spamthread #1

[Mog]

Ich hab mir den Mist nicht ausgedacht. Der Kunde will PHP und dann bekommt er PHP.
Und ich finde, zu jeder Bibliothek, egal ob nun OpenSource oder ClosedSource, gehört eine Dokumentation. Die muss ja nicht 1000 Seiten dick sein. Eine kleine Beschreibung zur Bibliothek und deren Funktionen würde schon reichen.
Und sowas ist bei PHP oftmals nicht gegeben, sodass selbst die Entwickler rätseln, was überhaupt einige Funktionen können und was nicht.

Schon traurig, dass sowas keine Selbstverständlichkeit ist ... Bei einer Welt, die angeblich sooooo viel Wert auf Dokumentation und Kommunikation legt ...

...

Jetzt klingst du gerade, wie ein Realitaetsverweigerer. Dokumentation ist -- egal ob bezahlt, oder nicht bezahlt -- alles andere als normal. ICh habe schon oft kommerzielle Bibliotheken in der Hand gehabt, bei denen man einfach durch probieren heraus finden musste, was Sache ist.

Du hast hier mindestens den Source. Da sehe ich echt kein Problem.

Prinzipiell gebe ich dir aber recht: Die Realität ist in dem Punkt nicht so schön.


Aber, wenn es was mit SSH ist, ist die Lib sowieso gebunden. Schau mla in ie C-Doku. Die hilft sicher weiter.

[Xardas der Dunkle]

Imho hat php eine sehr gute Doku o_O. Auf php.net habe ich bisher eigentlich fast immer das gefunden was ich suchte.
Das einzige was mir gerade einfällt ist eine Konstante für die Curl-Bibliothek welche in der Doku nicht auftaucht, aber das eine Konstante von weiß ich wie vielen vergessen wird ... *.

Und ich weiß nicht wo dein Problem liegt ... auch die SSH-Lib ist ausreichend dokumentiert ...
http://de2.php.net/manual/en/book.ssh2.php

Das würde ich mir für manche Software welche ich auf der Arbeit benutze wünschen ...

[Jesus_666]

Die PHP-Doku ist eine gemischte Sache: Für die üblichen Module ist sie vollständig und (abgesehen von Cocoa) jeder anderen mir bekannten Programmierumgebung deutlich überlegen. (Ja, Pythons Doku geht mehr in die Tiefe, dafür ist es schwer, das zu finden, was man eigentlich braucht.) Dafür sind die obskuren Module, die nur sehr selten mal jemand benutzt, teilweise komplett undokumentiert.

Generell funktioniert die PHP-Doku wirklich gut. Die Probleme treten fast immer in Randfällen auf und da für gewöhnlich bei Bindings zu externen Bibliotheken.