fix return types on lists to be IEnumerable<T> and update readme with await to reflect the new usages.