chore(docs): Add some of the missing docstrings

For , this refers to the context parameters returned by the lambda authorizer (optional)
For , this refers to the IAM authorization details

Author: michaelbrewer

aws_lambda_powertools/utilities/data_classes/api_gateway_proxy_event.py

@@ -270,6 +270,7 @@ def user_agent(self) -> str:
 class RequestContextV2AuthorizerIam(DictWrapper):
     @property
     def access_key(self) -> Optional[str]:
+        """The IAM user access key associated with the request."""
         return self.get("accessKey")
 
     @property
@@ -284,6 +285,8 @@ def caller_id(self) -> Optional[str]:
 
     @property
     def cognito_amr(self) -> Optional[List[str]]:
+        """This represents how the user was authenticated.
+        AMR stands for  Authentication Methods References as per the openid spec"""
         return self["cognitoIdentity"].get("amr")
 
     @property
@@ -310,6 +313,7 @@ def user_arn(self) -> Optional[str]:
 
     @property
     def user_id(self) -> Optional[str]:
+        """The IAM user ID of the effective user identified after authentication."""
         return self.get("userId")
 
 
@@ -324,10 +328,12 @@ def jwt_scopes(self) -> List[str]:
 
     @property
     def get_lambda(self) -> Optional[Dict[str, Any]]:
+        """Lambda authorization context details"""
         return self.get("lambda")
 
     @property
     def iam(self) -> Optional[RequestContextV2AuthorizerIam]:
+        """IAM authorization details used for making the request."""
         iam = self.get("iam")
         return None if iam is None else RequestContextV2AuthorizerIam(iam)