Ok, I agree. That makes sense and helps with consistency in language, though I've seen short descriptions on many other params during our development of the new v2 API so I'll point it out the others too.