-
-
Notifications
You must be signed in to change notification settings - Fork 174
Description
We use the term "second factor" and "authentication" in the documentation, but the usage of those two terms is confusing and slightly misguiding for users.
Every example of what we call "authentication" in the Inquiries section is actually a form of authorization. I realize that we should probably have at least one example that is different from a generic approval inquiry, but using the wrong word for the same concept really isn't a very instructive example for users.
Additionally, we should shy away from using the term "secondfactor", as it also seems to refer to "multi-factor authentication" (MFA) just using a different name, and all of those examples are similarly not actually illustrating authentication but authorization. I haven't seen any users using inquiries besides asking for a second approval, so restricting our examples to that use case should be fine for now. As we collect more feedback and more use cases we can create additional examples beyond the simple approval flow.
I realize that this is literally arguing over semantics, but words generally have distinct meanings and misusing terms to boost the count of our examples only serves to confuse and intimidate users against using inquiries in the first place.