Le codex n'est-il plus activement maintenu?
En général, je recherche Google lorsque j'ai besoin d'une référence rapide pour une fonction Wordpress, et c'est généralement un message du Codex qui apparaît en premier (par exemple. Https://codex.wordpress.org/Function_Reference/get_term quand googler 'get-term ').
Je me fie au codex depuis des années et je savais vaguement qu’il existait un code de référence distinct (par exemple, https://developer.wordpress.org/reference/functions/get_term/ ) qui nedonne plus de détails que le Codex ... mais apparaît généralement comme une liste en double. Parfois, cela revient en premier dans les recherches Google.
Mais récemment, j'ai constaté des divergences entre les deux ... et il semble que le Codex soit peut-être obsolète sur certains points. Par exemple, re. les deux liens ci-dessus - j'ai passé un peu de temps à lire les tickets de Trac avant de me rendre compte que $taxonomy n'était en effet plus un paramètre requis sur get_term(). J'étais sur le sentier du jardin parce que le Codex indique toujours qu'il estrequis.
Je ne vois nulle part dans le Codex qu'il soit mentionné, mais il existe des liens vers la référence du code en haut de chaque page.
Est-ce que quelqu'un sait si le Codex estobsolète? Est-il toujours utile? Ou devrais-je plutôt l'ignorer et simplement utiliser developer.wordpress.org ?
(hmm c'est un peu hors sujet, mais laissera les autres le décider)
Meilleure réponse
Bien qu'il soit difficile de suivre les annonces officielles, comme l'a souligné @darmb dans les commentaires, il semblerait que les efforts de documentation officielle s'éloignent du codex au profit du site du développeur et des sites/blogs "make". D'une certaine manière, bien que cela ne soit pas officiellement annoncé (dans la mesure du possible), le codex devrait être traité comme s'il était obsolète.
Références:
- "... l'objectif ultime étant de fermer le Codex." ( lien )
- "Le Codex est obsolète et devrait disparaître à un moment donné. Ainsi, la page de révision du thème du Codex n'est plus officielle, ni conservée." ( lien )
Réponse originale
Le codex est un site de style wiki. Pour être à jour, il faut que des volontaires aillent le modifier. Généralement, avec un nouveau code, vous obtiendrez quelque chose, bien que la qualité ne soit peut-être pas la meilleure, mais elle risque de souffrir de "bitrot" sur des sujets plus anciens avec des modifications mineures.
Le site de développement est un site de style phpdoc créé automatiquement à partir des commentaires de style phpdoc accompagnant les déclarations de fonction et l'utilisation des hooks. Il est donc synchronisé avec le code réel (vous pouvez y voir le code).
Point de douleur du codex - il peut s'écarter de la description réelle si personne ne se soucie de certaines API. Point fort, il est généré par l'homme pour l'homme et en théorie plus facile à éditer.
Point de douleur du site de développeur -it est seulement pour la dernière version et dépend de la qualité des commentaires dans le code, quelque chose qui en moyenne 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 effectuer une recherche dans le code.
Je pense que des informations trompeuses sont pires qu’aucune information et c’est pourquoi j’essaie d’éviter le codex, mais non, il n’est pas déprécié, et si vous trouvez un vide, n'hésitez pas à le remplir :)