Seq vs. List - Iterable, instead?

There are many cases in the docs where something is documented as returning a List, when it in fact returns a Seq these days.

My recommendation is that we spec these as returning an Iterable, not a particular class, and update roast and the docs to follow.