nit: would be nice if all function comments in this function were consistently declarative or imperative