Codex Version Fokus auf Produktion oder nächtlich?

Die function get_users_of_blog () soll in WP 3.1.0 veraltet sein, die aktuelle Produktionsversion ist 3.0.5.

Ist es notwendig, dass die Dokumentation eine nächtliche Änderung widerspiegelt, wenn die Produktionsversion von get_users_of_blog () immer noch die primäre function ist, die zum Abrufen einer Benutzerliste verwendet wird? Oder ist es in Ordnung, solange die veraltete Version auf dem Artikel aufgeführt ist?

Ich habe die Seite zurückgesetzt, um anzuzeigen, dass sie nicht veraltet war, aber schnell wieder in den ursprünglichen Zustand zurückversetzt wurde. Vermutlich verpasse ich nur etwas und hoffe, dass jemand etwas Licht ins Dunkel bringen könnte.

BEARBEITEN
@Kaiser wies darauf hin, dass der Codex ein Wild-West-Typ ist, einige Artikel sind 3.1, aktuell 3.0.5, und andere sind sehr veraltet.

Refokussieren meine Frage, was sollte die beste Praxis für die Dokumentation über ein beliebtes Framework wie WordPress, die öffentliche nächtliche Builds hat sein?

Solutions Collecting From Web of "Codex Version Fokus auf Produktion oder nächtlich?"

Der Kodex ist eine Art Chaos. Allgemeines Verhalten besteht darin, die Benutzer (neu) schreiben zu lassen und dann darüber zu gehen und zu ändern, was sie (wer auch immer das ist) denken. Ex. Dem Codex fehlen viele functionen in der functionsreferenz. An einigen Stellen haben Sie bereits die 3.1 Erklärungen, auf anderen völlig veralteten Sachen. Manchmal finden Sie zwei Versionen (aktuelle und zukünftige) oder vorhandene leere Seiten für zukünftige Vorlagen.

Auf get_users_of_blog() wir vorher eine Frage und das Problem ist, dass einige der functionen built_in diese function noch benutzen.

Daher ist get_users_of_blog ein merkwürdiger Fall, denn wenn man sich den Codex get_users_of_blog wird diese function abgeschrieben und man sollte get_users() das mit Version 3.1 ausgeliefert werden sollte

Aber wenn Sie sich wp_list_authors ansehen (eine eingebaute function), verwendet es get_users_of_blog () selbst.

Es ist in Codex als veraltet dokumentiert, hat jedoch keinen expliziten _deprecated_function() in der Quelle und wird nicht nach wp-includes/deprecated.php _deprecated_function() verschoben.

Es ist klar, dass die Dokumentation dem Code vorauseilt.