Le codex n'est-il plus maintenu activement?

J'utilise généralement Google lorsque j'ai besoin d'une référence rapide pour une fonction Wordpress, et généralement c'est un article du Codex qui apparaît en premier (par exemple, https://codex.wordpress.org/Function_Reference/get_term lorsque Google recherche «get-term»).

Je suis fié à des codex pendant des années, et était vaguement au courant qu'il y avait un code distinct de référence (par exemple. Https://developer.wordpress.org/reference/functions/get_term/ ) qui ne donne plus de détails que le Codex ... mais la plupart du temps, il s'agissait d'une liste en double. Parfois, cela revient d'abord dans les recherches Google.

Mais récemment, j'ai rencontré des divergences entre les deux ... et il semble que le Codex soit obsolète sur certains points. Par exemple, re. les deux liens ci-dessus - j'ai passé un peu de temps à lire les tickets trac avant de réaliser que ce $taxonomyn'est plus un paramètre obligatoire get_term(). J'étais sur le chemin du jardin parce que le Codex indique toujours que cela est nécessaire.

Je ne peux voir nulle part sur le Codex qui mentionne qu'il est obsolète, bien qu'il y ait des liens vers la référence du code en haut de chaque page.

Quelqu'un sait-il si le Codex est obsolète? Cela sert-il toujours un but? Ou devrais-je l'ignorer et utiliser simplement developer.wordpress.org ?

(hmm c'est un peu hors sujet, mais cela laissera les autres décider)

Meilleure réponse

Bien qu'il soit difficile de suivre l'annonce officielle, comme @darmb l'a souligné dans les commentaires, il y a des indications que l'effort de documentation officielle s'éloigne du codex en faveur du site du développeur et des "make" blogs / sites. Donc, d'une certaine manière, bien qu'il ne soit pas officiellement annoncé (pour autant qu'il soit possible de le voir), le codex doit être traité comme s'il était obsolète.

Références:

• "... avec pour objectif ultime de fermer le Codex." ( lien )
• "Le Codex est obsolète et devrait disparaître à un moment donné. Ainsi, la page d'examen des thèmes du Codex n'est plus officielle ni maintenue." ( lien )

Réponse originale

Le codex est un site de style wiki. Pour être à jour, certains bénévoles doivent aller le modifier. Habituellement, avec le nouveau code, vous obtiendrez quelque chose, bien que la qualité ne soit pas la meilleure, mais elle peut souffrir de "bitrot" sur des sujets plus anciens avec des changements mineurs.

Le site du développeur est un site de style phpdoc généré automatiquement à partir des commentaires de style phpdoc accompagnant les déclarations de fonction et l'utilisation du hook, il est donc synchronisé avec le code réel (et vous pouvez réellement voir le code ici).

Point douloureux du codex - il peut différer de la description réelle si personne ne se soucie d'une API. Point fort, il est généré par l'homme pour l'homme et en théorie plus facile à éditer.

Le point douloureux du site du développeur - c'est uniquement pour la dernière version et dépend de la qualité des commentaires dans le code, quelque chose qui, en moyenne, ne peut changer que tous les 4 mois. Point fort - il vous montre le code lui-même, remplaçant l'utilisation de l'éditeur de texte pour rechercher dans le code.

Je pense que les informations trompeuses sont pires alors pas d'informations et donc j'essaie d'éviter le codex, mais non, ce n'est pas obsolète, et si vous trouvez une lacune là-bas, vous êtes les bienvenus pour la combler :)