Wird der Kodex nicht mehr aktiv gepflegt?

Ich google im Allgemeinen, wenn ich eine Kurzreferenz für eine Wordpress-Funktion benötige, und im Allgemeinen wird zuerst ein Codex-Beitrag angezeigt (z. B. https://codex.wordpress.org/Function_Reference/get_term, wenn "get-term" gegoogelt wird).

Ich habe mich jahrelang auf den Codex verlassen und war mir vage bewusst, dass es eine separate Code-Referenz (z. B. https://developer.wordpress.org/reference/functions/get_term/ ) gab , die detaillierter war als der Codex ... schien aber meistens eine doppelte Auflistung zu sein. Manchmal wird dies stattdessen zuerst in der Google-Suche zurückgegeben.

Aber in letzter Zeit bin ich auf Unterschiede zwischen den beiden gestoßen ... und es scheint, dass der Kodex in einigen Dingen veraltet ist. Zum Beispiel re. Die beiden obigen Links - Ich habe ein bisschen Zeit damit verbracht, Trac-Tickets zu lesen, bevor mir klar wurde, dass dies $taxonomytatsächlich kein erforderlicher Parameter mehr ist get_term(). Ich war auf dem Gartenweg , da der Codex noch Listen , dass es ist erforderlich.

Ich kann im Codex nirgendwo sehen, dass er veraltet ist, obwohl oben auf jeder Seite Links zur Code-Referenz vorhanden sind.

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

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

Bessere Antwort

Obwohl es schwierig ist, offizielle Ankündigungen zu verfolgen, gibt es, wie @darmb in den Kommentaren hervorhob, Hinweise darauf, dass die offiziellen Dokumentationsbemühungen zugunsten der Entwicklerseite und der "make" -Blogs / -Seiten vom Kodex abweichen. In gewisser Weise sollte der Kodex so behandelt werden, als wäre er veraltet, obwohl er nicht offiziell angekündigt wurde (soweit dies ersichtlich ist).

Verweise:

• "... mit dem ultimativen Ziel, den Codex irgendwann zu schließen." ( Link )
• "Der Codex ist veraltet und wird voraussichtlich irgendwann verschwinden. Daher ist die Seite zur Themenüberprüfung im Codex nicht mehr offiziell oder wird nicht mehr gepflegt." ( Link )

Ursprüngliche Antwort

Der Codex ist eine Wiki-Site. Um auf dem neuesten Stand zu sein, müssen einige Freiwillige es tatsächlich 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 kann es zu "Bitrot" kommen.

Die Entwickler-Site ist eine Site im Phpdoc-Stil, die automatisch aus den Kommentaren im Phpdoc-Stil generiert wird, die Funktionsdeklarationen und die Verwendung von Hooks begleiten. 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. Die Stärke ist, dass der Mensch für den Menschen erzeugt und theoretisch leichter 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. Stärke - es zeigt Ihnen den Code selbst und ist ein Ersatz für die Verwendung des Texteditors zum Suchen im Code.

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