Кодекс больше не поддерживается активно?

Я обычно использую Google, когда мне нужен краткий справочник по функции Wordpress, и обычно это сообщение Кодекса, которое появляется первым (например, https://codex.wordpress.org/Function_Reference/get_term при поиске в Google 'get-term').

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

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

Я нигде не вижу в Кодексе упоминания о том, что он устарел, хотя в верхней части каждой страницы есть ссылки на Кодовые ссылки.

Кто - нибудь знает , если Кодекс является устаревшим? Это все еще служит цели? Или я должен в значительной степени игнорировать это и просто использовать developer.wordpress.org ?

(хм, это несколько не по теме, но пусть другие решат это)

Лучший ответ

Несмотря на то, что сложно отследить официальное объявление, как отметил @darmb в комментариях, есть признаки того, что усилия по официальной документации отходят от кодекса в пользу сайта разработчика и «блогов» блогов / сайтов. Таким образом, в некотором смысле, хотя официально не объявлено (насколько это возможно увидеть), кодекс следует рассматривать так, как если бы он был объявлен устаревшим.

Ссылки:

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

Оригинальный ответ

Кодекс - это сайт в стиле вики. Это обновление требует, чтобы некоторые добровольцы действительно пошли и отредактировали это. Обычно с новым кодом вы получаете что-то там, хотя качество может быть не самым лучшим, но оно может страдать от «битрота» на старых темах с небольшими изменениями.

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

Болевая точка кодекса - он может отличаться от реального описания, если никто не заботится о каком-то API. Сильной стороной является то, что человек создан для людей, и в теории его легче редактировать.

Болевая точка сайта разработчика - это только для последней версии и зависит от качества комментариев в коде, то, что на avarage может меняться только каждые 4 месяца. Сильная сторона - он показывает сам код, заменяя текстовый редактор для поиска в коде.

Я думаю, что вводящая в заблуждение информация хуже, чем отсутствие информации, и поэтому я стараюсь избегать кодекса, но нет, он не считается устаревшим, и если вы найдете там пробел, вы можете его заполнить :)