¿El códice ya no se mantiene activamente?

9

Generalmente busco en Google cuando necesito una referencia rápida para una función de Wordpress, y generalmente es una publicación del Codex que aparece primero (por ejemplo, https://codex.wordpress.org/Function_Reference/get_term cuando busco en Google 'get-term').

He estado confiando en el códice durante años, y era vagamente consciente de que había una referencia de código separado (por ejemplo. Https://developer.wordpress.org/reference/functions/get_term/ ) que hizo dar más detalles que el Codex ... pero en su mayoría parecía ser una lista duplicada. A veces, esto vuelve primero en las búsquedas de Google.

Pero recientemente me he encontrado con discrepancias entre los dos ... y parece que el Codex puede estar desactualizado en algunas cosas. Por ejemplo, re. los dos enlaces anteriores: pasé un poco de tiempo leyendo tickets de trac antes de darme cuenta de que $taxonomyya no es un parámetro obligatorio get_term(). Estaba en el camino del jardín porque el Codex todavía enumera que es obligatorio.

No puedo ver en ninguna parte del Codex que mencione que está en desuso, aunque hay enlaces a la Referencia del Código en la parte superior de cada página.

¿Alguien sabe si el Codex está en desuso? ¿Sigue sirviendo un propósito? ¿O debería ignorarlo y simplemente usar developer.wordpress.org ?

Tim Malone
fuente

Respuestas:

8

(hmm esto es algo fuera de tema, pero permitirá que otros decidan sobre ello)

Mejor respuesta

Aunque es difícil rastrear el anuncio oficial, como señaló @darmb en los comentarios, hay indicios de que el esfuerzo de documentación oficial se está alejando del códice a favor del sitio del desarrollador y los blogs / sitios de "creación". Entonces, en cierto modo, aunque no se anuncie oficialmente (por lo que es posible ver), el códice debe tratarse como si estuviera en desuso.

Referencias

  • "... con el objetivo final de cerrar el Codex". ( enlace )
  • "El Codex está en desuso y está programado para desaparecer en algún momento. Por lo tanto, la página de revisión de temas en el Codex ya no es oficial ni se mantiene". ( enlace )

Respuesta original

El códice es un sitio de estilo wiki. Estar actualizado requiere que algunos voluntarios realmente vayan a editarlo. Por lo general, con el nuevo código obtendrá algo allí, aunque la calidad puede no ser la mejor, pero puede sufrir de "bitrot" en temas antiguos con cambios menores.

El sitio de desarrollador es un sitio de estilo phpdoc generado automáticamente a partir de los comentarios de estilo phpdoc que acompañan a las declaraciones de funciones y el uso del gancho, por lo tanto, está sincronizado con el código real (y en realidad puede ver el código allí).

Punto crítico del códice: puede diferir de la descripción real si a nadie le importa alguna API. El punto fuerte es que es generado por humanos para humanos y en teoría es más fácil de editar.

Punto crítico del sitio para desarrolladores: es solo para la última versión y depende de la calidad de los comentarios en el código, algo que en promedio puede cambiar solo cada 4 meses. Punto fuerte: le muestra el código en sí mismo, siendo un reemplazo para usar el editor de texto para buscar en el código.

Creo que la información engañosa es peor que la falta de información y, por lo tanto, trato de evitar el códice, pero no, no está en desuso, y si encuentra un vacío, puede llenarlo :)

Mark Kaplun
fuente
Perfecto, muchas gracias por esta explicación, Mark. No me di cuenta de que el sitio del desarrollador se documentó automáticamente, eso tiene mucho sentido. En lo que respecta a la pregunta fuera de tema, me pregunté eso antes de publicarlo, pero había buscado en Google y no pude encontrar una respuesta ... y se relaciona directamente con Wordpress ... Pensé que si lo veía aquí, pensaría que es una gran pregunta, así que decidí publicarlo de todos modos. ¡Feliz de que me aconsejen lo contrario!
Tim Malone
2
Realmente releyendo wordpress.stackexchange.com/help/on-topic , no veo cómo está fuera de tema ...
Tim Malone
@TimMalone, las preguntas de wordpress.org deben dirigirse al material de wordpress.org. Otto es visto aquí de vez en cuando, pero de lo contrario no hay nadie con autoridad para responder a este tipo de preguntas que se ciernen por aquí. Básicamente está preguntando sobre la recomendación de un "libro";)
Mark Kaplun
1
En realidad, el Codex está en proceso de desaprobación a medida que se crean los nuevos documentos de desarrollador. Numerosas páginas del Codex ahora redirigen automáticamente a los nuevos documentos de desarrollador.
darrinb
1
Aquí hay una referencia a que el Codex está en desuso: make.wordpress.org/themes/2015/05/27/…
darrinb