Documentation effort

[Benudek (benedikt herudek)]

check this @Brennon: Documentation improvements

I think backwards compatibility is relevant when you had the code in production orgs.