can we be more explicitly in explaining the `null` case? like "in case of null, the provider SHOULD return all routes that it knows about."

is this optional? would it be ok to return a partial collection, or is it either all or nothing?