added api documentation for oauth2-lib

done for [AGIOS-273](https://issues.jboss.org/browse/AGIOS-273)
perhaps, let's say what it actually offers? including method docs?