Codex Update Needed for is_main_query Page

Per @nacin‘s comment on this ticket, the is_main_query() function reference page needs to be updated:

This Codex page needs some work to actually explain what is going on. It documents only the function, yet is linked from the WP_Query page, and the only example is using the method.

I’m committing a _doing_it_wrong() message, but this Codex page needs a lot of love in order to keep this in 3.7. Otherwise we’re just telling users what they’re doing wrong without giving them any information to help them correct it.

We need someone to make the necessary updates. Please leave a comment if you’re interested in helping out.