[3.0] Add JavaDocs for some API methods, restrict access to some
methods, add some more checks