it-swarm.com.de

Wird der Kodex nicht mehr aktiv gepflegt?

Ich googe im Allgemeinen, wenn ich eine Kurzreferenz für eine Wordpress-Funktion benötige, und im Allgemeinen ist es ein Codex-Beitrag, der zuerst angezeigt wird (z. B. https://codex.wordpress.org/Function_Reference/get_term , wenn ich den Begriff google ').

Ich habe mich seit Jahren auf den Codex verlassen und war mir vage bewusst, dass es eine separate Codereferenz gibt (z. B. https://developer.wordpress.org/reference/functions/get_term/ ), die hat detaillierter angegeben als der Codex ... schien aber größtenteils eine doppelte Auflistung zu sein. Manchmal wird dies stattdessen zuerst in Google-Suchen zurückgegeben.

Aber kürzlich bin ich auf Unterschiede gestoßen ... und es scheint, dass der Codex in einigen Dingen veraltet ist. Zum Beispiel re. Die beiden obigen Links - Ich habe ein wenig Zeit damit verbracht, Trac-Tickets zu lesen, bevor mir klar wurde, dass $taxonomy in der Tat kein erforderlicher Parameter mehr für get_term() ist. Ich war auf dem Gartenweg, weil der Codex immer noch auflistet, dass es ist erforderlich ist.

Ich kann nirgendwo im Codex nachlesen, dass er veraltet ist, obwohl es oben auf jeder Seite Links zur Code-Referenz gibt.

Weiß jemand, ob der Codex ist veraltet ist? Hat es noch einen Zweck? Oder sollte ich es so ziemlich ignorieren und einfach developer.wordpress.org verwenden?

9
Tim Malone

(hmm das ist etwas unangebracht, lässt aber andere darüber entscheiden)

Bessere Antwort

Obwohl es schwierig ist, offizielle Ankündigungen zu verfolgen, gibt es Hinweise darauf, dass der offizielle Dokumentationsaufwand zugunsten der Entwickler-Website und der "make" -Blogs Sites vom Kodex abweicht. In gewisser Weise sollte der Kodex so behandelt werden, als ob er veraltet wäre, obwohl er nicht offiziell angekündigt wurde (soweit dies ersichtlich ist).

Verweise:

Ursprüngliche Antwort

Der Codex ist eine Wiki-Site. Um auf dem neuesten Stand zu sein, müssen einige Freiwillige das Dokument bearbeiten. Normalerweise erhalten Sie mit neuem Code etwas, obwohl die Qualität möglicherweise nicht die beste ist, aber bei älteren Themen mit geringfügigen Änderungen unter "Bitrot" leidet.

Die Entwickler-Site ist eine Site im PHP-Stil, die automatisch aus den Kommentaren im PHP-Stil generiert wird, die den Funktionsdeklarationen und der Hook-Verwendung beigefügt sind. Daher ist sie mit dem tatsächlichen Code synchronisiert (und Sie können den Code dort tatsächlich sehen).

Schmerzpunkt des Kodex - er kann von der tatsächlichen Beschreibung abweichen, wenn sich niemand um eine API kümmert. Starker Punkt, der vom Menschen für den Menschen generiert wurde und theoretisch einfacher zu bearbeiten ist.

Schmerzpunkt der Entwicklerseite - es ist nur für die neueste Version und hängt von der Qualität der Kommentare im Code ab, was sich im Durchschnitt nur alle 4 Monate ändern kann. Starker Punkt - es zeigt Ihnen den Code selbst, als Ersatz für die Verwendung des Texteditors, um im Code zu suchen.

Ich denke, dass irreführende Informationen schlimmer sind als keine Informationen und daher versuche ich, den Kodex zu umgehen, aber nein, er ist nicht veraltet. Wenn Sie dort eine Lücke finden, können Sie diese gerne ausfüllen :)

8
Mark Kaplun