食典版本专注于生产还是夜间?

时间:2011-02-15 作者:Workman

功能get_users_of_blog() 将在WP 3.1.0中弃用,但当前的生产版本是3.0.5。

当get\\u users\\u of\\u blog()的生产版本仍然是用于获取用户列表的主要函数时,让文档反映夜间的更改是否有意义?还是只要文章中列出了不推荐的版本就可以了?

我将页面还原回原来的状态,以反映它没有被弃用,但很快就恢复到原来的状态。我可能只是错过了一些东西,希望有人能对此有所了解。

EDIT

再次强调我的问题,对于像Wordpress这样有公共夜间构建的流行框架,文档的最佳实践应该是什么?

3 个回复
最合适的回答,由SO网友:kaiser 整理而成

法典有点乱。一般的行为是让用户(重新)编写它,然后检查它并改变他们(无论这是谁)的想法。例如,Codex在函数参考中缺少很多函数。在一些地方,你已经得到了3.1的解释,在其他完全过时的东西上。有时你会发现two versions (current and future) 或模板标记的现有空白页coming in the future.

SO网友:Bainternet

在…上get_users_of_blog() 我们有a question before 问题是一些内置函数仍然使用此函数。

所以get_users_of_blog 这是一个奇怪的情况,因为看看法典,是的,这个函数被贬值了,你应该使用get_users() 应随版本3.1一起提供

但如果您查看wp\\u list\\u authors(一个内置函数),它使用get\\u users\\u of\\u blog()本身。

SO网友:Rarst

它在Codex中被记录为已弃用,但没有明确的_deprecated_function() 调用源,但未移动到wp-includes/deprecated.php.

很明显,文档运行在代码之前。

结束

相关推荐

WordPress Codex的本地副本?

有时我想在没有网络连接的情况下开发WordPress主题。我需要Function Reference 和Template Tags 要有生产力。我搜索了一份可下载或SVN版本的Codex 但找不到。最后我试着用镜子把它照出来wget, 但结果参差不齐(太大了!)。有更好的办法吗?