Wird der Kodex nicht mehr aktiv gepflegt?

9

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 ?

Tim Malone
quelle

Antworten:

8

(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 :)

Mark Kaplun
quelle
Perfekt, vielen Dank für diese Erklärung Mark. Ich wusste nicht, dass die Entwicklerseite automatisch dokumentiert wurde, das macht durchaus Sinn. In Bezug auf die Frage, die nicht zum Thema gehört, habe ich das selbst in Frage gestellt, bevor ich sie gepostet habe, aber ich hatte gegoogelt und konnte keine Antwort finden. Und sie bezieht sich direkt auf Wordpress. Ich dachte, wenn ich sie hier sehen würde, würde ich denken, dass es so ist Eine großartige Frage, also habe ich beschlossen, sie trotzdem zu posten. Gerne aber anders beraten!
Tim Malone
2
Beim erneuten Lesen von wordpress.stackexchange.com/help/on-topic sehe ich nicht, wie es nicht zum Thema gehört ...
Tim Malone
@ TimMalone, wordpress.org-Fragen sollten an wordpress.org gerichtet werden. Von Zeit zu Zeit wird Otto hier gesichtet, aber sonst gibt es niemanden, der befugt ist, diese Art von Frage zu beantworten, die hier herumhängt. Sie fragen im Grunde nach Empfehlungen für ein "Buch";)
Mark Kaplun
1
Tatsächlich wird der Codex derzeit veraltet, da die neuen Entwicklerdokumente erstellt werden. Zahlreiche Seiten des Codex leiten jetzt automatisch zu den neuen Entwicklerdokumenten weiter.
Darrinb
1
Es gibt einen Hinweis darauf, dass der Codex hier veraltet ist: make.wordpress.org/themes/2015/05/27/…
darrinb