Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Adds addressRegion to the address claim table for international addresses #305

Merged
merged 2 commits into from
Dec 13, 2024

Conversation

Caitlin-cooling
Copy link
Contributor

@Caitlin-cooling Caitlin-cooling commented Dec 10, 2024

Do not merge this PR until we've got approval from the policy board that we can go ahead

Why

To ensure the docs about VCs reflect changes for international addresses

What

Adding addressRegion to address claim table

Technical writer support

Yes

How to review

Changes can be viewed locally at http://localhost:4567/integrate-with-integration-environment/prove-users-identity/#understand-your-user-s-address-claim

Confirm

  • I have checked if any docs change here also requires updates to other repositories (ADRs / RFCs, README.md, Team Manual, elsewhere in these docs)
  • Where there is any overlap I have updated or opened a PR for corresponding changes

@@ -296,6 +296,7 @@ Each JSON object in the list may contain any of the following properties:
| `addressLocality` | Maps to `POST_TOWN` in the [Postcode Address File][external.postcode-file] and [Ordnance Survey Places API][external.os-places-api]. |
| `postalCode` | Maps to `POST_CODE` in the [Postcode Address File][external.postcode-file] and [Ordnance Survey Places API][external.os-places-api]. |
| `addressCountry` | Two-letter [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). |
| `addressRegion` | The region in which the locality is, and which is in the country, provided as text. For example, California, or another appropriate first-level Administrative division. |

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could we include something to say that it aligns to https://schema.org/addressRegion? eg.

Suggested change
| `addressRegion` | The region in which the locality is, and which is in the country, provided as text. For example, California, or another appropriate first-level Administrative division. |
| `addressRegion` | The region in which the locality is, and which is in the country, provided as text. For example, California, or another appropriate first-level Administrative division. This maps to [schema:addressRegion](https://schema.org/addressRegion) |

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done

philf999
philf999 previously approved these changes Dec 12, 2024
Copy link
Contributor

@philf999 philf999 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me and the inclusion of the maps to keeps it consistent with the other attributes.

Co-authored-by: SteveEvans-GDS <[email protected]>
Copy link
Contributor

@ImogenCraigmile ImogenCraigmile left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just the one query about Administrative division but otherwise looks really good!

Copy link
Contributor

@ImogenCraigmile ImogenCraigmile left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@Caitlin-cooling Caitlin-cooling merged commit cc1189b into main Dec 13, 2024
2 checks passed
@Caitlin-cooling Caitlin-cooling deleted the international-addresses branch December 13, 2024 09:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants