web-dev-qa-db-ja.com

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

私はWordpressの機能のクイックリファレンスが必要なときは一般的にグーグル、そしてそれは一般的に最初に登場するコーデックスの投稿です(例: https://codex.wordpress.org/Function_Reference/get_term googling 'get-term ')。

私は何年もコーデックスに頼っていました、そしてそれがした)別のコードリファレンス(例えば https://developer.wordpress.org/reference/functions/get_term/ )があることを漠然と認識していましたCodexよりも詳細な情報を入力してください...しかし、ほとんどが重複したリストであるように見えました。

しかし、最近私はこの2つの間に矛盾があることに遭遇しました...そして、それはコーデックスがいくつかの事に関して時代遅れであるかもしれないようです。たとえば。上記の2つのリンク - 私は、$taxonomyget_term()の必須パラメーターではなくなったことに気づく前に、tracチケットを読むのに少し時間を費やしました。コーデックスではまだそれがisrequired)と表示されているので、私はガーデンパス上にいました。

各ページの上部にコードリファレンスへのリンクがありますが、私はそれが廃止予定であると言っているコーデックスのどこにも見ることができません。

誰かがCodex isが廃止予定かどうか知っていますか?それはまだ目的にかなっていますか?それとも無視して developer.wordpress.orgを使うだけですか?

9
Tim Malone

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

より良い答え

公式の発表を追跡するのは難しいですが、@ darmbがコメントで指摘したように、公式の文書化の努力が開発者サイトと "make"ブログ/サイトを支持してコーデックスから離れているという指摘があります。したがって、ある意味では、公式には発表されていませんが(可能な限り)、コーデックスは廃止予定であるかのように扱われるべきです。

参照:

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

元の答え

コーデックスはウィキスタイルのサイトです。最新の状態にするには、何人かのボランティアが実際に行って編集する必要があります。通常、新しいコードを使用すると、そこに何かが入りますが、品質は最高ではないかもしれませんが、古いトピックの「bitrot」に若干の変更があるだけで問題が生じる可能性があります。

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

コーデックスの問題点 - 誰かが何らかのAPIを気にかけていない場合、実際の説明とは異なる場合があります。長所それは人間のために人間が生み出したものであり、理論上は編集がより簡単です。

開発者向けサイトの問題点は、最新版のみで、コード内のコメントの質に左右されます。これは4ヶ月ごとに変わる可能性があるものです。長所 - テキストを使ってコードを検索する代わりに、自分自身でコードを表示します。

私は誤解を招く情報は悪い情報より悪い情報ではないと思うので、私はコーデックスを避けようとします、しかし、いいえ、それは非推奨ではありません

8
Mark Kaplun