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

9

Eu geralmente uso o Google quando preciso de uma referência rápida para uma função do Wordpress, e geralmente é uma postagem do Codex que aparece primeiro (por exemplo, enlace quando pesquisando 'get-term').

Eu venho confiando no códice há anos e estava vagamente ciente de que havia uma Referência de código separada (por exemplo, enlace ) que fez dar mais detalhes do que o Codex ... mas a maior parte parecia ser uma listagem duplicada. Às vezes, isso retorna primeiro nas pesquisas do Google.

Mas recentemente eu 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 pouco de tempo lendo os tickets do trac antes de perceber que $taxonomy não é mais um parâmetro obrigatório em get_term() . Eu estava no caminho do jardim porque o Codex ainda lista que é necessário.

Não consigo ver nenhum lugar no Codex que mencione que está obsoleto, embora haja links para a Referência de código no topo de cada página.

Alguém sabe se o Codex é obsoleto? Ainda serve a um propósito? Ou eu deveria estar ignorando isso e apenas usando developer.wordpress.org ?

    
por Tim Malone 18.04.2016 / 03:45

1 resposta

8

(hmm isso é um pouco fora do tópico, mas deixa os outros decidirem sobre isso)

Melhor resposta

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

Referências:

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

Resposta original

O codex é um site de estilo wiki. Estar atualizado requer alguns voluntários para ir e editá-lo. Normalmente, 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 declarações de função e uso do hook, portanto ele está em sincronia com o código (e você pode ver o código).

Ponto de dor do códice - pode divergir da descrição real se ninguém se importar com alguma API. Ponto strong é humano gerado para os seres humanos e, em teoria, mais fácil de editar.

Ponto de dor do site do desenvolvedor - é apenas para a versão mais recente e depende da qualidade dos comentários no código, algo que em média pode mudar apenas a cada 4 meses. Ponto strong - mostra o próprio código, sendo um substituto para usar o editor de texto para pesquisar no código.

Eu acho que a informação enganosa é pior do que nenhuma informação e, portanto, eu tento evitar o códice, mas não, não é obsoleto, e se você encontrar uma lacuna lá, você é bem-vindo para preenchê-lo:)

    
por Mark Kaplun 18.04.2016 / 04:56