问题描述

我通常是 Google，当我需要一个 Wordpress 功能的快速参考，一般来说，它是一个 Codex 的帖子，首先出现 (例如，https://codex.wordpress.org/Function_Reference/get_term 当谷歌’get-term’) 。

我多年来一直依靠食品法典，并且模糊地意识到，有一个单独的代码参考 (例如 https://developer.wordpress.org/reference/functions/get_term/) 比食典提供了更多的细节… 但是大多数似乎是一个重复的列表。有时这会在 Google 搜索中首先返回。

但最近我遇到了两者之间的差异… 似乎食典可能在某些事情上已经过时了。例如，上面的两个链接 – 我花了一点时间阅读 trac 门票之前，我意识到 $taxonomy 确实不再是 get_term()的必需参数。我在花园路上，因为食典仍然列出了它的需要。

我不能看到 Codex 上的任何提到它已被弃用，尽管每个页面顶部都有指向 「代码参考」 的链接。

有人知道食典是否被弃用？它仍然有目的吗？或者我应该几乎忽略它，只是使用 developer.wordpress.org？

最佳解决方案

(嗯，这有点是 off-topic，但会让别人决定)

更好的答案

虽然很难跟踪官方公告，但是 @darmb 在评论中指出，有迹象表明官方文档的工作正在偏离开源网站和”make” 博客/网站。所以在某种程度上，虽然没有正式宣布 (尽可能看到)，但是这些法典应该被视为已经被弃用了。

参考文献：

  • 「… 最终目标是最终关闭食典。」 (link)

  • 「食典委已被弃用，因此在某一时刻将会被淘汰，因此，」 食品法典 「的」 主题评论 「页面已不再是官方或维系的。 (link)

原来的答案

codex 是一个维基风格的网站。它是最新的，需要一些志愿者去实际去编辑它。通常使用新的代码，你会得到一些东西，虽然质量可能不是最大的，但它可能会遭受”bitrot” 在较旧的主题与微小的变化。

开发者站点是 phpdoc 样式网站，由 phpdoc 样式注释自动生成，附带函数声明和钩子使用，因此它与实际代码同步 (您可以看到代码在那里) 。

codex 的痛点 – 如果没有人关心某些 API，它可能与实际描述分歧。人类生成的强项，理论上更容易编辑。

开发人员网站的痛点 – 只适用于最新版本，并且取决于代码中的评论质量，只有每 4 个月才可能发生变化。强点 – 它显示自己的代码，替代使用文本编辑器来搜索代码。

我认为这个误导性信息比没有信息更糟糕，所以我尽量避免使用鳕鱼，但不是不被弃用，如果你发现一个差距，欢迎填写它:)

参考文献

注：本文内容整合自 Google/Baidu/Bing 辅助翻译的英文资料结果。如果您对结果不满意，可以加入我们改善翻译效果：薇晓朵技术论坛。