it-swarm-eu.dev

Není již kodex aktivně udržován?

I obecně Google, když potřebuji rychlý odkaz na funkci Wordpress, a obecně je to Codex post, který přijde první (např. https://codex.wordpress.org/Function_Reference/get_term , když je služba Googling 'get-term').

Dlouho jsem se spoléhal na kodex a byl jsem si nejasně vědom, že existuje samostatná kódová reference (např. https://developer.wordpress.org/reference/functions/get_term/ ), že udělal více podrobností než Codex ... ale většinou se zdálo, že jde o duplicitní zápis. Někdy se místo toho vrátí nejdříve ve vyhledáváních Google.

Ale nedávno jsem narazil na nesrovnalosti mezi nimi ... a zdá se, že Kodex může být u některých věcí zastaralý. Například re. dva odkazy nahoře - strávil jsem trochu času čtením vstupenek na trac, než jsem si uvědomil, že $taxonomy již není v parametru get_term() požadovaným parametrem. Byl jsem na zahradní cestě, protože Codex stále uvádí, že je vyžadováno .

Nevidím nikde na Codexu, který by zmínil, že je zastaralý, ačkoli v horní části každé stránky jsou odkazy na kódové odkazy.

Ví někdo, zda Codex je zastaralý? Stále slouží účelu? Nebo bych ho měl ignorovat a používat developer.wordpress.org ?

9
Tim Malone

(hmm to je poněkud mimo téma, ale ostatní se o tom rozhodnou)

Lepší odpověď

Ačkoli je těžké sledovat oficiální oznámení, jak @darmb uvedl v komentářích, existují náznaky, že oficiální úsilí o dokumentaci se vzdaluje od kodexu ve prospěch stránek developerů a blogů/stránek "make". Takže způsobem, který není oficiálně oznámen (pokud je to možné), by se s kodexem mělo zacházet tak, jako by byl zastaralý.

Reference:

  • "... s konečným cílem je nakonec vypnout Kodex." ( odkaz )
  • "Kodex je zastaralý a je v určitém okamžiku kritizovaný, aby zmizel. Tedy, stránka Téma recenze na Kodexu již není oficiální ani udržovaná." ( odkaz )

Původní odpověď

Kodex je webová stránka ve stylu wiki. To je aktuální vyžaduje, aby někteří dobrovolníci skutečně jít a upravovat. Obvykle s novým kódem dostanete něco tam, i když kvalita nemusí být největší, ale může trpět "bitrot" na starších tématech s menšími změnami.

Stránka vývojáře je webová stránka ve stylu phpdoc, která je automaticky generována z komentářů ve stylu phpdoc doprovázejících deklarace funkcí a použití háčků, proto je synchronizována se skutečným kódem (a kód tam můžete skutečně vidět).

Bolestový bod kodexu - může se lišit od skutečného popisu, pokud se nikdo nestará o nějaké API. Je to silná stránka, kterou člověk vytváří pro lidi, a teoreticky snadněji upravovat.

Bod bolestí na stránkách vývojáře - to je pouze pro nejnovější verzi a závisí na kvalitě komentářů v kódu, něco, co se na průměru může měnit pouze každé 4 měsíce. Silný bod - ukazuje vám kód, který je sám o sobě náhradou za použití textového editoru pro vyhledávání v kódu.

Myslím si, že zavádějící informace jsou horší než žádné informace, a proto se snažím vyhnout kodexu, ale ne, není to zastaralé, a pokud zde najdete mezeru, můžete ji vyplnit :)

8
Mark Kaplun