search

gctools-outilsgc / aurora-website

Aurora is a central design system for all products and applications for the Open, Accessible Digital Workspace. This repo is for all code and issues related to the Aurora documentation website.
https://design.gccollab.ca/
MIT License
16 stars 9 forks source link

Names, addresses, and dates #226

Open jkshapiro opened 5 years ago

jkshapiro commented 5 years ago

Since this is a design system, it would benefit from including some material on how to collect and display names, addresses, and dates.

Some source material that might be useful:

Names:

Addresses:

Dates:

jkshapiro commented 5 years ago

Actually, addresses and dates are decently covered at https://design.gccollab.ca/content/formatting.

s-duffey commented 5 years ago

@jkshapiro did you want to suggest more improvements for this or do you feel it's adequately covered in the Formatting page?

jkshapiro commented 5 years ago

If it were me I'd mention ISO 8601, but that's nice to have. The current material on addresses and dates works for me.

For names, there's a common antipattern where a form will ask for three fields: first name, middle initial, and last name. There are a bunch of people out there for whom that doesn't work, including everyone with a first initial, everyone with just one name, and everyone whose family name comes before their given name, and I think this is a reasonable place to call that out.

RobJohnston commented 5 years ago

Another source of addresses, for Canada, the US, and International, is Canada Post: https://www.canadapost.ca/tools/pg/manual/PGaddress-e.asp#1416993

s-duffey commented 5 years ago

Thanks @RobJohnston! I think we actually used Canada Post as a base for address validation in one of our apps. Might be nice to include here. I'll do a bit more research and add it in when I have time :)

RobJohnston commented 5 years ago

first name, middle initial, and last name. There are a bunch of people out there for whom that doesn't work, including everyone with a first initial, everyone with just one name, and everyone whose family name comes before their given name,

At IRCC, we've been using the terms "Given name" and "Family name", and making the given name optional. I think the inspiration came to us from a person who had been working at Passport.

RobJohnston commented 5 years ago

Some more existing (bilingual) source material:

Dates: https://www.canada.ca/en/treasury-board-secretariat/services/government-communications/canada-content-style-guide.html#wp4-7

Addresses: https://www.canada.ca/en/treasury-board-secretariat/services/government-communications/canada-content-style-guide.html#wp4-10