I understand it STANKS!

The problem is that Oracle has different people write different chapters in these docs and some have a better grip on the language then others.
Notwithstanding, there should be some type of audit in place for some consistency.

No speka di engleesh.

There is a lot to be said for keeping things simple, although some (and you know who you are) would disagree.