Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

[docs-scanner] 2FA account recovery instructions contain logical contradiction

オープン 初心者向け
#26,084 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
72/100
issue の種類
ドキュメント
明瞭さ
おおむね明確
活発さ
活発
技術スタック
docker

調査の方向性

content/manuals/security/authentication/2fa/recover-hub-account.md を開き、現在の "Recover your account without access" セクションを確認します。Docker の実際のサインインおよび 2FA 回復フローを検証し、紛失したデバイスのオプションが認証の前と後のどちらに表示されるか、また Contact Support フォームが必須かどうかを確認します。手順がユーザーエクスペリエンスと一致し、矛盾する手順を提示していなければ完了です。

索引モデルが issue の本文から書いたものです。

説明

File: content/manuals/security/authentication/2fa/recover-hub-account.md

Issue

The "Recover your account without access" section instructs users to sign in with username and password when they've lost both their 2FA device and recovery code:

If you lost access to both your two-factor authentication application and your recovery code:

  1. Sign in to your Docker account with your username and password.
  2. Select I've lost my authentication device and I've lost my recovery code.
Why this matters

This is a logical contradiction that will confuse users in a critical account recovery situation. When 2FA is enabled on an account, signing in requires:

  1. Username and password
  2. The 2FA code from the authenticator app

If a user has lost their authentication device, they cannot provide the 2FA code, which means they cannot complete step 1 (signing in). The instructions don't explain how to bypass the 2FA prompt or access the "I've lost my authentication device" option without being able to sign in first.

A user following these instructions will be stuck at the sign-in page, unable to proceed to step 2 where they can indicate they've lost their device.

Suggested fix

Clarify the actual recovery flow. Possible approaches:

  1. If there's a "lost device" link on the sign-in page itself (before completing authentication), explain that:

    • Go to the sign-in page
    • Enter username and password
    • When prompted for 2FA code, select "I've lost my authentication device"
    • Then select "I've lost my recovery code"
  2. If users must contact support without being able to sign in at all, simplify to:

    • If you've lost both your authentication device and recovery code, you cannot sign in
    • Complete the Contact Support form with your primary email address for recovery instructions

The instructions should match the actual user experience when 2FA blocks sign-in.


Found by nightly documentation quality scanner

主要言語
Markdown
スター
4.7k
フォーク
8.5k
平均マージ
2日 18時間
マージ済み PR(30日)
121

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

docker/docs のほかの issue

docker/docs の issue をすべて見る

似ている issue

Security の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。