I think it would be helpful if the documentation for the getVariants() and getRepresentation() methods would make it clear that the order in which the variants are in the variants list specifies the preferred variant (all else being equal).
I.e., if I add TEXT_PLAIN and then TEXT_HTML then TEXT_PLAIN will be selected as the preferred variant regardless of the ordering of the fields in the Accept: header (but it does basically respect the q values). The spec seems to be ambiguous on the ordering issue but it's common practice to put the preferred types in descending order. Thoughts? Thanks, John
