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

Enhancement idea: documentation links per-type-of-2FA #1431

Open
tvierling opened this issue Nov 24, 2015 · 2 comments
Open

Enhancement idea: documentation links per-type-of-2FA #1431

tvierling opened this issue Nov 24, 2015 · 2 comments
Labels
enhancement Issue/PR contains enhancements to the overall code of the site. feature Feature request

Comments

@tvierling
Copy link
Contributor

Recently I submitted some changes for facebook which really didn't fit the design of the site. But in researching background info, it was clear that their documentation of the different 2FA methods wasn't all in one place. I've noticed this pattern at some other sites, too.

It might be nice to have links in the checkmark cells (or perhaps make the checkmarks themselves linkable) which provide site-specific documentation on actually setting up a given type of 2FA.

It's great to know where 2FA is available, but not all sites make it simple to find out how to set it up. This could provide more comprehensive coverage of each popular site's 2FA options, and specifically give users a quick jump-off point to the instructions on how to use a given option.

@smholloway
Copy link
Contributor

How is the proposed change different than the Docs link currently present?

@tvierling
Copy link
Contributor Author

It's different by exactly what you just said: it's currently a link (singular).

Several sites have different documentation pages based on the type of 2FA to be set up. In the case of Facebook which is the example here, they have all of the following which are not documented all in one place:

SMS: https://www.facebook.com/help/148233965247823

OATH via Facebook's mobile app: https://www.facebook.com/help/270942386330392

TOTP OATH via any other app: https://www.facebook.com/help/358336074294704

Sure, the current doc link (which is the SMS link above) has "related articles" listed, including ones that are unhelpful -- but isn't the point to get users to start using 2FA as easily and quickly as possible?

Really, this comes down to the question of whether twofactorauth.org is meant to be a site that says "look here and good luck", or "look here for setup instructions for your use case". The latter would need more comprehensive documentation linking capability.

@Carlgo11 Carlgo11 added the enhancement Issue/PR contains enhancements to the overall code of the site. label Nov 24, 2015
@Carlgo11 Carlgo11 added the feature Feature request label Jul 26, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement Issue/PR contains enhancements to the overall code of the site. feature Feature request
Projects
Status: Suggested
Development

No branches or pull requests

3 participants