Il codice non è più mantenuto attivamente?

In genere ho Google quando ho bisogno di un riferimento rapido per una funzione di Wordpress, e in genere è un post del Codex che compare per primo (ad es. Https://codex.wordpress.org/Function_Reference/get_term quando google "get-term").

Ho fatto affidamento sul codice per anni, ed ero vagamente consapevole che c'era un codice di riferimento separato (ad es. Https://developer.wordpress.org/reference/functions/get_term/ ) che ha dare più dettagli rispetto al Codex ... ma per lo più sembrava essere un elenco duplicato. A volte questo ritorna prima nelle ricerche di Google.

Ma recentemente ho riscontrato discrepanze tra i due ... e sembra che il Codice potrebbe non essere aggiornato su alcune cose. Ad esempio, ri. i due link sopra - ho passato un po 'di tempo a leggere i ticket trac prima di rendermi conto che in $taxonomyeffetti non è più un parametro richiesto get_term(). Ero sul sentiero del giardino perché il Codice indica ancora che è necessario.

Non riesco a vedere da nessuna parte sul Codice che menziona che è deprecato, anche se ci sono collegamenti al Codice di riferimento nella parte superiore di ogni pagina.

Qualcuno sa se il Codice è deprecato? Serve ancora uno scopo? O dovrei praticamente ignorarlo e usare solo developer.wordpress.org ?

(hmm questo è un po 'fuori tema, ma lascerà che altri lo decidano)

Risposta migliore

Sebbene sia difficile tracciare l'annuncio ufficiale, come sottolineato da @darmb nei commenti, ci sono indicazioni che lo sforzo di documentazione ufficiale si sta allontanando dal codice a favore del sito degli sviluppatori e dei blog / siti "make". Quindi, in un certo senso, sebbene non annunciato ufficialmente (per quanto è possibile vedere), il codice dovrebbe essere trattato come se fosse deprecato.

Riferimenti:

• "... con l'obiettivo finale è quello di chiudere il Codice." ( link )
• "Il Codice è deprecato ed è programmato per andare via ad un certo punto. Pertanto, la pagina di revisione del tema sul Codice non è più ufficiale o mantenuta." ( link )

Risposta originale

Il codice è un sito in stile wiki. Essere aggiornati richiede che alcuni volontari vadano effettivamente a modificarlo. Di solito con un nuovo codice otterrai qualcosa lì, anche se la qualità potrebbe non essere la migliore, ma potrebbe soffrire di "bitrot" su argomenti più vecchi con modifiche minori.

Il sito per sviluppatori è un sito in stile phpdoc generato automaticamente dai commenti in stile phpdoc che accompagnano le dichiarazioni di funzioni e l'utilizzo dell'hook, quindi è sincronizzato con il codice reale (e puoi effettivamente vedere il codice lì).

Punto dolente del codice: può divergere dalla descrizione effettiva se a nessuno importa di alcune API. Punto di forza è generato dall'uomo per l'uomo e in teoria più facile da modificare.

Il punto debole del sito dello sviluppatore è solo per l'ultima versione e dipende dalla qualità dei commenti nel codice, qualcosa che in media può cambiare solo ogni 4 mesi. Punto di forza: ti mostra il codice da solo, in sostituzione dell'utilizzo dell'editor di testo per cercare nel codice.

Penso che le informazioni fuorvianti siano peggio di nessuna informazione e quindi cerco di evitare il codice, ma no, non è deprecato e se trovi un vuoto lì sei invitato a colmare :)