問題描述

我通常是 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 輔助翻譯的英文資料結果。如果您對結果不滿意，可以加入我們改善翻譯效果：薇曉朵技術論壇。