The function get_users_of_blog() is to be deprecated in WP 3.1.0 but the current production release is 3.0.5.
Does it make since to have the documentation reflect a nightly change when the production version of get_users_of_blog() is still the primary function used to fetch a list of users? Or is it fine so long as the version it is deprecated is listed on the article?
I reverted the page back to reflect that it was not deprecated but it was reverted quickly back to it's original state. I'm probably just missing something and was hoping someone would shed some light on this.
@kaiser pointed out that the codex is a wild-west of sorts, some articles are up-to-future to 3.1, up-to-date with 3.0.5, and others are very outdated.
Refocusing my question, what should be the best practice for documentation on a popular framework like Wordpress that does have public nightly builds?