Updated to match release 1.2.2

Review wording please
Yes, sure. Should we put up such implementation internals? Not necessarily for keeping secrets, but for doc brevity too.