Чи кодекс більше не підтримується активно?

Я, як правило, Google, коли мені потрібна швидка довідка про функцію Wordpress, і зазвичай це повідомлення Codex, яке з'являється першим (наприклад, https://codex.wordpress.org/Function_Reference/get_term, коли Google "отримує термін").

Я покладався на Codex в протягом багатьох років, і смутно усвідомлював , що було окремої Коду (наприклад. Https://developer.wordpress.org/reference/functions/get_term/ ) , що було дати більше деталей , ніж у Кодексі ... але, здебільшого, схоже, що це дубльований список. Іноді це повертається спочатку у пошукових запитах Google.

Але останнім часом я зіткнувся з розбіжностями між двома ... і, здається, у деяких кодексах Кодекс може застаріти. Наприклад, повторно. два посилання вище - я витратив трохи часу на читання квитків на автобуси, перш ніж зрозумів, що $taxonomyце дійсно більше не потрібний параметр get_term(). Я був на шляху в саду , тому що до сих пір Кодексу списки , що це необхідно.

Я не бачу ніде в Кодексі, що згадує про застарілий, хоча вгорі кожної сторінки є посилання на довідник про код.

Хто - небудь знає , якщо Кодекс є застарілим? Чи все ж це служить цілі? Або я повинен сильно ігнорувати це та просто використовувати developer.wordpress.org ?

(Хм, це дещо поза темою, але дозволить іншим вирішити питання)

Краща відповідь

Хоча офіційне оголошення важко відслідковувати, як @darmb в коментарях зазначає, є вказівки на те, що зусилля офіційної документації відходять від кодексу на користь сайту розробника та "роблять" блоги / сайти. Таким чином, хоча офіційно не оголошено (наскільки це можливо), до кодексу слід ставитися так, ніби він був устареним.

Список літератури:

• "... з кінцевою метою - врешті-решт закрити Кодекс". ( посилання )
• "Кодекс застарілий і в якийсь момент планується відійти. Таким чином, сторінка Тематичного огляду на Кодексі більше не є офіційною або підтримується." ( посилання )

Оригінальна відповідь

Кодекс - це сайт у стилі вікі. Оновлення вимагає, щоб деякі волонтери насправді перейшли та відредагували його. Зазвичай з новим кодом ви щось отримаєте там, хоча якість може бути не найвищою, але він може страждати від "бітрота" на старіші теми з незначними змінами.

Сайт розробника - це сайт у стилі phpdoc, автоматично створений із коментарів стилю phpdoc, що супроводжують декларації функцій та використання гака, для цього він синхронізується з фактичним кодом (і ви дійсно можете побачити код там).

Точка болю кодексу - вона може відрізнятися від фактичного опису, якщо ніхто не піклується про якийсь API. Дуже важливо, що це породжене людиною і теоретично простіше відредагувати.

Біль сайту розробника - це лише для останньої версії і залежить від якості коментарів у коді, що може змінюватися лише на кожні 4 місяці. Сильна сторона - вона показує вам код, який ви самостійно, заміняючи використання текстового редактора для пошуку в коді.

Я думаю, що оманлива інформація є гіршою, ніж ніяка інформація, і тому я намагаюся уникати кодексу, але ні, вона не застаріла, і якщо ви знайдете прогалину там, можете запросити її :)