¿Ya no se mantiene activamente el códice?

9

Generalmente busco en Google cuando necesito una referencia rápida para una función de Wordpress, y generalmente es una publicación de Codex que aparece primero (por ejemplo, enlace cuando busque en Google 'get-term').

He estado confiando en el códice durante años y estaba vagamente consciente de que había una Referencia de Código por separado (por ejemplo, enlace ) que proporcionó más detalles que el Codex ... pero en su mayoría parece ser una lista duplicada. A veces, esto vuelve primero en las búsquedas de Google.

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

No puedo ver en ningún lugar del Codex que se 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 Códice está en desuso? ¿Todavía sirve un propósito? ¿O debería ignorarlo y simplemente usar developer.wordpress.org ?

    
pregunta Tim Malone 18.04.2016 - 03:45

1 respuesta

8

(hmm, esto es un poco fuera de tema, pero dejará que otros lo decidan)

Mejor respuesta

Aunque es difícil hacer un seguimiento del anuncio oficial, como @darmb señaló en los comentarios, hay indicios de que el esfuerzo de documentación oficial se está alejando del códice en favor del sitio del desarrollador y de los blogs / sitios "make". Entonces, de alguna manera, aunque no se anuncie oficialmente (por lo que se puede 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 del tema en el Codex ya no es oficial, ni se mantiene". ( link )

Respuesta original

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

El sitio para desarrolladores 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 usted puede ver el código allí).

Punto negativo del códice: puede desviarse de la descripción real si a nadie le importa un poco de API. El punto fuerte es que los humanos lo generan y, en teoría, es más fácil de editar.

Punto negativo del sitio del desarrollador: es solo para la versión más reciente y depende de la calidad de los comentarios en el código, algo que en general puede cambiar solo cada 4 meses. Punto fuerte: 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 no información y, por lo tanto, trato de evitar el códice, pero no, no está en desuso, y si encuentra un hueco, le invitamos a que lo llene :)

    
respondido por el Mark Kaplun 18.04.2016 - 04:56

Lea otras preguntas en las etiquetas