O códice não é mais mantido ativamente?

Geralmente, procuro no Google quando preciso de uma referência rápida para uma função do Wordpress, e geralmente é um post do Codex que aparece primeiro (por exemplo, https://codex.wordpress.org/Function_Reference/get_term ao pesquisar no Google 'get-term').

Eu estive contando com o códice por anos, e estava vagamente consciente de que havia uma referência de código separado (eg. Https://developer.wordpress.org/reference/functions/get_term/ ) que se dar mais detalhes do que o Codex ... mas principalmente parecia ser uma listagem duplicada. Às vezes, isso retorna primeiro nas pesquisas do Google.

Mas recentemente me deparei com discrepâncias entre os dois ... e parece que o Codex pode estar desatualizado em algumas coisas. Por exemplo, re. os dois links acima - passei um tempo lendo trac tickets antes de perceber que esse não $taxonomyé mais um parâmetro obrigatório get_term(). Eu estava no caminho do jardim porque o Codex ainda lista que é necessário.

Não consigo ver em nenhum lugar do Codex que ele esteja obsoleto, embora haja links para a Referência de código na parte superior de cada página.

Alguém sabe se o Codex está obsoleto? Ainda serve a um propósito? Ou devo ignorá-lo e usar apenas developer.wordpress.org ?

(hmm, isso é algo fora de tópico, mas permitirá que outros decidam sobre isso)

Melhor resposta

Embora seja difícil rastrear o anúncio oficial, como o @darmb apontou nos comentários, há indicações de que o esforço de documentação oficial está se afastando do códice em favor do site do desenvolvedor e dos blogs / sites "make". De certa forma, embora não seja anunciado oficialmente (até onde é possível ver), o códice deve ser tratado como se tivesse sido preterido.

Referências:

• "... com o objetivo final de encerrar o Codex." ( link )
• "O Codex está obsoleto e está programado para desaparecer em algum momento. Assim, a página de Revisão do Tema no Codex não é mais oficial ou mantida". ( link )

Resposta original

O codex é um site no estilo wiki. Para estar atualizado, alguns voluntários devem editá-lo. Geralmente, com o novo código, você obtém algo lá, embora a qualidade possa não ser a melhor, mas pode sofrer "bitrot" em tópicos mais antigos com pequenas alterações.

O site do desenvolvedor é um site no estilo phpdoc gerado automaticamente a partir dos comentários no estilo phpdoc que acompanham as declarações de função e o uso do gancho; portanto, ele está sincronizado com o código real (e você pode realmente ver o código lá).

Ponto problemático do códice - ele pode divergir da descrição real se ninguém se importar com alguma API. O ponto forte é que ele é gerado por humanos e, em teoria, é mais fácil de editar.

O ponto crítico do site do desenvolvedor - é apenas para a versão mais recente e depende da qualidade dos comentários no código, algo que na média pode mudar apenas a cada 4 meses. Ponto forte - mostra o código, sendo um substituto para o uso do editor de texto para pesquisar no código.

Penso que informações enganosas são piores do que nenhuma informação e, portanto, tento evitar o códice, mas não, não é preterido e, se você encontrar uma lacuna, poderá preenchê-la :)