Maintenance Iteration 22 - typos and formatting

[nils-work]

This change request has been created to simplify the raising of typos and formatting changes in Maintenance Iteration 22.

If the change has a real impact on readability and clarity it should be posted on the Maintenance Iteration Holistic Feedback issue for the community's visibility.

Maintenance Iteration 22

• Holistic Feedback issue:
  • TBC
• Decision Proposal:
  • TBC

[nils-work]

Remove bold on the '(optional)' statement, add bullets for the two JwksUri points:

[nils-work]

Replace two instances of (ie. with (i.e.

[nils-work]

Update value style in the sentence:

True if the End-User's e-mail address has been verified; otherwise false. When this Claim Value is true,

true if the End-User's e-mail address has been verified; otherwise false. When this Claim Value is true,

[nils-work]

Correct typo in description referring to hasCentralProtectionAndControl to hasCentralProtectionControl.

[nils-work]

Resolve local build script message (from running /slate/run.sh):

Please add the following to your Gemfile to avoid polling for changes:
gem 'wdm', '>= 0.1.0' if Gem.win_platform?

[nils-work]

Adjust positioning and size of tooltips for referenced specifications.

[nils-work]

Replace four instances of e-mail with email for consistency.

[nils-work]

Apply bold style to keywords: MAY, SHOULD, MUST, MUST NOT, etc.

[nils-work]

Continuation of changes from previous MI issue, changing remaining -

• "must play back" to "MUST play back" in x-fapi-interaction-id header description
• "data holder must respond with a 406 Not Acceptable" to "data holder MUST respond with a 406 Not Acceptable" in x-v and x-min-v header descriptions

[nils-work]

Display default parameter and property values in schema tables to improve awareness/visibility.

[nils-work]

Replace 'data holder' and 'register' in the respective x-v and x-min-v header statements with 'endpoint' to make common statements. e.g.,:

• "The data holder SHOULD" --> "The endpoint SHOULD"
• "The Register SHOULD" --> "The endpoint SHOULD"
• "If all versions requested are not supported then the data holder" --> "If all versions requested are not supported then the endpoint"
• "If all versions requested are not supported then the Register" --> "If all versions requested are not supported then the endpoint"

[nils-work]

Update the descriptions of the Get Data Holder Brands parameters to align to other endpoints:
From:

page: The page number to return.
page-size: The number of records to return per page.

to:

page: Page of results to request (standard pagination).
page-size: Page size to request. Default is 25 (standard pagination).

[nils-work]

Replace variations of the x-v response header description:

The version of the API endpoint that the holder has responded with.

The version of the API endpoint that the data holder has responded with.

The version of the API endpoint that the CDR Register has responded with.

with:

The payload version that the endpoint has responded with.