I don't really like these unspecific warnings in the docs. Just point to the index docs, and be specific enough about what's allowed in them. Which in your case means adding docs about the boolean `true` notation as well as the SQL string notation.