Le codex n'est-il plus maintenu activement?

9

En général, je recherche Google quand j'ai besoin d'une référence rapide pour une fonction Wordpress, et c'est généralement un message Codex qui apparaît en premier (par exemple, enlace lorsque Google "get-term").

Je me base sur le codex depuis des années et je savais vaguement qu'il existait un code de référence distinct (par exemple, enlace ) que a fourni plus de détails que le Codex ... mais semble en grande partie être 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 trace avant de réaliser que $taxonomy n'était plus un paramètre obligatoire sur get_term() . J'étais sur le chemin du jardin parce que le Codex indique toujours qu'il est requis .

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.

Quelqu'un sait-il si le Codex est obsolète? Est-ce que ça sert toujours? Ou devrais-je plutôt l'ignorer et utiliser simplement developer.wordpress.org ?

    
posée Tim Malone 18.04.2016 - 03:45

1 réponse

8

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

Meilleure réponse

Bien qu’il soit difficile de suivre l’annonce officielle, comme @darmb l’a souligné dans les commentaires, il semblerait que l’effort de documentation officielle s'éloigne du codex au profit du site du développeur et des sites / blogs "make". Donc, d’une certaine manière, même s’il n’a pas été 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." ( link )
  • "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." ( link )

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 le 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 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 des hooks. Il est donc synchronisé avec le code réel (et vous pouvez y voir le code).

Point douloureux 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 à modifier.

Point critique du site du développeur - il s’agit uniquement de la dernière version et dépend de la qualité des commentaires dans le code, ce 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 effectuer une recherche dans le code.

Je pense que les informations trompeuses sont pires que les autres et que j’essaie donc d’éviter le codex, mais non, elles ne sont pas déconseillées. Si vous trouvez un vide, vous pouvez le remplir:)

    
réponse donnée Mark Kaplun 18.04.2016 - 04:56

Lire d'autres questions sur les étiquettes