Hi,
I also raised that issue too when making the doc. People had the opition to use -parameter. I made the doc, I also followed the practice. I see newer code also does that thing, so in my mind I was following a practice/advice properly.
I gave the doc to Joel and maybe he can decide what to do with it. Anyway maybe the governance should be a good try for this one.