Adding REST spec docs for HTTP Basic endpoints

Done for [AGPUSH-859](https://issues.jboss.org/browse/AGPUSH-859)

Using jax-doclets, like Keycloak does.

Example deployment: http://people.apache.org/~matzew/UPS_REST_API/overview-index.html