Fix RBAC capitalization, minor typos JWT & OIDC

    - Updated README.adoc
    - Updated Specs background
    - Updated Javadocs package-info

Signed-off-by: Emerson Castaneda <[email protected]>

Author: emecas

README.adoc

@@ -21,9 +21,9 @@
 
 ## Introduction
 
-Today, the most common solutions involving RESTful and microservices security are based on http://openid.net/connect/[OpenID Connect(OIDC)], https://tools.ietf.org/html/rfc6749[OAuth2] and https://tools.ietf.org/html/rfc7519[JSON Web Token (JWT)] standards.
+Today, the most common solutions involving RESTful and microservices security are based on http://openid.net/connect/[OpenID Connect (OIDC)], https://tools.ietf.org/html/rfc6749[OAuth2] and https://tools.ietf.org/html/rfc7519[JSON Web Token (JWT)] standards.
 
-This specification outlines how the signed JWT tokens issued by OIDC and other trusted providers can be verified and their claims used for role based access control(RBAC) of microservice endpoints.
+This specification outlines how the signed JWT tokens issued by OIDC and other trusted providers can be verified and their claims used for Role Based Access Control (RBAC) of microservice endpoints.
 
 ## Motivation
 

api/src/main/java/org/eclipse/microprofile/jwt/package-info.java

@@ -22,8 +22,8 @@
  * <p>Interoperable JWT RBAC for Microprofile
  *
  * <h2>Overview</h2>
- * This package contains the primary interfaces and support classes for the JSON Web Tokens(JWT) for role based
- * access control(RBAC) of MicroProfile microservice endpoints. The primary class is the JsonWebToken interface
+ * This package contains the primary interfaces and support classes for the JSON Web Tokens (JWT) for Role Based
+ * Access Control (RBAC) of MicroProfile microservice endpoints. The primary class is the JsonWebToken interface
  * that defines the view of the current authenticated user and associated JWT claims. It is available for injection
  * as well as the user principal available from the container security API.
  *

spec/src/main/asciidoc/background.asciidoc

@@ -16,8 +16,8 @@
 //
 
 ## Introduction
-This specification outlines a proposal for using http://openid.net/connect/[OpenID Connect(OIDC)] based
-https://tools.ietf.org/html/rfc7519[JSON Web Tokens(JWT)] for role based access control(RBAC) of microservice endpoints.
+This specification outlines a proposal for using http://openid.net/connect/[OpenID Connect (OIDC)] based
+https://tools.ietf.org/html/rfc7519[JSON Web Tokens (JWT)] for Role Based Access Control (RBAC) of microservice endpoints.
 
 
 ## Motivation
@@ -52,8 +52,8 @@ any information within a security token
 * Support for both delegation and impersonation of identities
 
 Today, the most common solutions involving RESTful and microservices security are based on https://tools.ietf.org/html/rfc6749[OAuth2],
-http://openid.net/connect/[OpenID Connect(OIDC)] and
-https://tools.ietf.org/html/rfc7519[JSON Web Tokens(JWT)]  standards.
+http://openid.net/connect/[OpenID Connect (OIDC)] and
+https://tools.ietf.org/html/rfc7519[JSON Web Tokens (JWT)]  standards.
 
 ### Token Based Authentication
 Token Based Authentication mechanisms allow systems to authenticate, authorize and verify identities based on a security token. Usually, the following entities are involved: