During buildfest, I attempted to create a has_many association on a model that orders referenced elements when fetching them. The documentation does not show how to do this, and I eventually had to resort to a GitHub code search to figure out how to get this done.

In addition to that, the options available on associations are not fully documented. The documentation could do with more examples for more complex association mappings that users may want to create.