Apply suggestions from code review

Co-authored-by: Martin <[email protected]>

services/proxy/README.md

@@ -112,16 +112,16 @@ service using the claim values configured in
 `PROXY_AUTOPROVISION_CLAIM_DISPLAYNAME`.
 
 If the user does already exist, the proxy will check if the user's email or
-displayname has changed and update those accordingly via `graph` service.
+displayname has changed and updates those accordingly via `graph` service.
 
 Next, the proxy will check if the user is a member of the groups configured in
 `PROXY_AUTOPROVISION_CLAIM_GROUPS`. It will add the user to the groups listed
-in there and remove it from all other groups that it is currently a member of.
-Groups that do not exist yet will be created. Note: This can be a somewhat
-costly operation, especially if the user is a member of a large number of
+via the OIDC claim that holds the groups defined in the envvar and removes it from
+all other groups that he is currently a member of.
+Groups that do not exist in the external IDP yet will be created. Note: This can be a
+somewhat costly operation, especially if the user is a member of a large number of
 groups. If the group memberships of a user are changed in the IDP after the
-first login it can take up to 5 minutes until the changes are reflected in
-ownCloud Infinite Scale.
+first login, it can take up to 5 minutes until the changes are reflected in Infinite Scale.
 
 ## Automatic Quota Assignments
 
@@ -150,9 +150,8 @@ is unset.
 When `PROXY_ROLE_ASSIGNMENT_DRIVER` is set to `oidc` the role assignment for a user will happen
 based on the values of an OpenID Connect Claim of that user. The name of the OpenID Connect Claim to
 be used for the role assignment can be configured via the `PROXY_ROLE_ASSIGNMENT_OIDC_CLAIM`
-environment variable. It is also possible to defe ine a mapping of claim values to role names defined
-in ownCloud Infinite Scale via a `yaml` configuration. See the following `proxy.yaml` snippet for an
-example.
+environment variable. It is also possible to define a mapping of claim values to role names defined
+in Infinite Scale via a `yaml` configuration. See the following `proxy.yaml` snippet for an example.
 
 ```yaml
 role_assignment: