コーデックスはもはや積極的に維持されていませんか?


9

私は通常、Wordpress関数のクイックリファレンスが必要なときにGoogleを使用します。通常、最初に表示されるのはCodexの投稿です(たとえば、「get-term」をグーグル検索するときはhttps://codex.wordpress.org/Function_Reference/get_term)。

私は長年、コーデックスに依存する、と別々のコードリファレンスがあったことを漠然と認識していたされてきた(例えば。https://developer.wordpress.org/reference/functions/get_term/を)ことでしたコーデックスよりも詳細を与えます...しかし、ほとんどが重複したリストのように見えました。代わりに、これはGoogle検索で最初に戻ることがあります。

しかし、最近、私は2つの間に矛盾を見つけました...そして、コーデックスはいくつかの事柄で時代遅れになっているようです。たとえば、re。上記の2つのリンク- $taxonomy本当に必要なパラメーターではなくなったことに気付く前に、少し時間をかけてトラックのチケットを読みましたget_term()。コーデックスにはまだそれ必要であると記載されているので、私は庭の道にいました。

各ページの上部にコードリファレンスへのリンクがありますが、非推奨であると言及しているCodexのどこにも表示されません。

コーデックス廃止されたかどうか誰かが知っていますか?それはまだ目的を果たしていますか?または、私はそれをほとんど無視して、developer.wordpress.orgを使用するべきですか?

回答:


8

(うーん、これはやや話題から外れていますが、他の人がそれを決めるようにするでしょう)

より良い答え

公式発表を追跡することは困難ですが、@ darmbがコメントで指摘したように、公式ドキュメントの取り組みが開発者サイトと「make」ブログ/サイトのためにコーデックスから遠ざかっていることを示しています。したがって、ある意味では、公式に発表されていませんが(確認できる範囲で)、コーデックスは廃止されたかのように扱う必要があります。

参照:

  • 「...最終的にはコーデックスをシャットダウンすることを最終目標としています。」(リンク
  • 「コーデックスは非推奨であり、いずれ廃止される予定です。そのため、コーデックスのテーマレビューページは公式ではなくなり、維持されなくなりました。」(リンク

元の答え

コーデックスはwikiスタイルのサイトです。最新の状態にするには、実際に行って編集するボランティアが必要です。通常、新しいコードで何かが得られますが、品質は最高ではないかもしれませんが、小さな変更を加えた古いトピックの「ビットロット」の影響を受ける可能性があります。

開発者サイトは、関数宣言とフックの使用法に伴うphpdocスタイルのコメントから自動生成されたphpdocスタイルのサイトです。そのため、実際のコードと同期しています(実際にコードを確認できます)。

codexの問題点-誰かがAPIを気にしない場合、実際の説明とは異なる可能性があります。強みは人間のために人間が作成したものであり、理論的には編集が簡単です。

開発者サイトの問題点-最新バージョンのみであり、コード内のコメントの品質に依存します。これは、平均して4か月ごとにしか変更されない可能性があることです。強み-それはあなた自身にコードを示し、テキストエディタを使用してコードを検索する代わりになります。

誤解を招く情報は情報がないより悪いと思うので、私はコーデックスを避けようとしますが、それは非推奨ではありません。そこでギャップを見つけたら、それを記入してください:)


パーフェクト、この説明の山に感謝します。マーク。開発者サイトが自動的に文書化されていることに気づかなかった、それは完全に理にかなっている。トピックから外れている質問については、投稿する前に自分自身に質問しましたが、Googleで回答を見つけることができませんでした。それはWordpressに直接関連しています。ここで見た場合、それはいい質問なので、とにかく投稿することにしました。それ以外の場合はアドバイスさせていただきます!
Tim Malone

2
実際にwordpress.stackexchange.com/help/on-topicを読み直しましたが、どのようにトピックから外れているのかわかりません...
Tim Malone

@ TimMalone、wordpress.orgの質問はwordpress.orgに関するものに送ってください。オットーは時々ここで発見されますが、それ以外の場合、ここにぶら下がっているこの種の質問に答える権限を持つ人は誰もいません。あなたは基本的に「本」の推奨について尋ねています;)
Mark Kaplun

1
実際、Codexは、新しい開発者ドキュメントが作成されるため、廃止される予定です。Codexの多数のページが、新しい開発者ドキュメントに自動的にリダイレクトされるようになりました。
darrinb

1
ここでは廃止さコーデックスへの参照があります:make.wordpress.org/themes/2015/05/27/...
darrinb
弊社のサイトを使用することにより、あなたは弊社のクッキーポリシーおよびプライバシーポリシーを読み、理解したものとみなされます。
Licensed under cc by-sa 3.0 with attribution required.