Skip to content

Introduce UX guidelines documentation #311

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

Open
wants to merge 5 commits into
base: main
Choose a base branch
from

Conversation

stephenmcgruer
Copy link
Collaborator

@stephenmcgruer stephenmcgruer commented Aug 8, 2025

See #309

@stephenmcgruer stephenmcgruer force-pushed the smcgruer-nonnormativeUXGuidelines branch from a6c7888 to 777d29f Compare August 11, 2025 14:53
@stephenmcgruer stephenmcgruer changed the title First draft, WIP Introduce UX guidelines documentation Aug 11, 2025
@stephenmcgruer stephenmcgruer force-pushed the smcgruer-nonnormativeUXGuidelines branch 2 times, most recently from 5f3bd63 to 9dce038 Compare August 11, 2025 15:04
@stephenmcgruer stephenmcgruer force-pushed the smcgruer-nonnormativeUXGuidelines branch from 9dce038 to e0be04f Compare August 11, 2025 15:06
@stephenmcgruer stephenmcgruer marked this pull request as ready for review August 11, 2025 15:18
Copy link
Collaborator

@ianbjacobs ianbjacobs left a comment

Choose a reason for hiding this comment

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

Thanks for starting this! My only comment on the images is whether a fake bank name in the card art would be preferable.

ux-guidelines.md Outdated
Comment on lines 24 to 25
The payee information fields are intended to communicate to the user who will
be the recipient of the funds. In most cases this would be the merchant (or
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
The payee information fields are intended to communicate to the user who will
be the recipient of the funds. In most cases this would be the merchant (or
The payee information fields are intended to communicate to the user: who will
be the recipient of the funds. In most cases this would be the merchant (or

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Why the :?

Copy link
Collaborator

Choose a reason for hiding this comment

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

I was hoping to avoid grammatical ambiguity. You can read "the user who will be the recipient of the funds" to mean the user is the recipient. If there were a comma after "user" that would be the definitive meaning, but there's no comma and so that's not the meaning. Except it sounds that way kind of also when you read it. :) So I thought maybe a colon could help. I used the same "trick" throughout.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Ah I see! I have tried to reword it to avoid that, what do you think?

@stephenmcgruer
Copy link
Collaborator Author

Thanks for starting this! My only comment on the images is whether a fake bank name in the card art would be preferable.

Great catch, fixed!

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.

2 participants