[docs-scanner] SSO overview omits OAT as CLI authentication option
メンテナーはふだん 1 日以内に返信
評価
- 難易度
- 1/5
- 見積もり時間
- 1〜3時間
- 初心者へのやさしさ
- 92/100
- issue の種類
- ドキュメント
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
- 技術スタック
- markdown
調査の方向性
content/manuals/security/authentication/single-sign-on/_index.mdを読み、同じディレクトリにあるconnect.mdとそのImportantの注意書きを比較してください。概要を更新してPATとOATに言及するか、設定ガイドを読者に案内してください。概要で両方の認証方法が明確に示されていれば完了です。
索引モデルが issue の本文から書いたものです。
説明
File: content/manuals/security/authentication/single-sign-on/_index.md
Issue
The SSO overview mentions only PAT for CLI authentication when SSO is enforced, but omits OAT (organization access token) as an option:
When SSO is enforced, the Docker CLI rejects password sign-in. Use a personal access token (PAT) to sign in to the CLI.
However, connect.md in the same directory correctly mentions both options:
Before enforcing SSO, users accessing Docker through the CLI must create a personal access token (PAT). The PAT replaces their password for authentication. For CI/CD and other automation, replace passwords with a PAT or an organization access token (OAT).
Why this matters
Readers of the overview page learn they need a PAT but don't discover that OAT exists as an option. For organizational and CI/CD use cases, OAT is often the more appropriate choice. This omission affects decision-making about which token type to use.
Suggested fix
Update the Important callout in _index.md to mention both PAT and OAT:
When SSO is enforced, the Docker CLI rejects password sign-in. Use a personal access token (PAT) or organization access token (OAT) to sign in to the CLI. For CI/CD and automation, OAT is often more appropriate.
Or add a sentence after the existing callout that references the fuller explanation in the setup guide.
Found by nightly documentation quality scanner
- 主要言語
- Markdown
- スター
- 4.7k
- フォーク
- 8.5k
- 平均マージ
- 2日 9時間
- マージ済み PR(30日)
- 136
環境構築
- Dockerfile または Docker Compose ファイルあり
- プルリクエストのテンプレートあり
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
docker/docs のほかの issue
-
status/triage
難易度 1/5 1時間未満 初心者へのやさしさ 85/100
メンテナーはふだん 1 日以内に返信
-
status/triage
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
メンテナーはふだん 1 日以内に返信
-
[docs-scanner] Inconsistent terminology: 'nested organization' vs 'organization in the company'対応中かも @dave123981 が 1 日前に担当しました。 オープン
難易度 1/5 1時間未満 初心者へのやさしさ 88/100
メンテナーはふだん 1 日以内に返信
-
status/triage
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
docker/docs#26484 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
メンテナーはふだん 1 日以内に返信
似ている issue
-
agent-butler-finding bug
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
jordansmall/spindrift#6236 ·
メンテナーはふだん 1 日以内に返信
-
documentation
難易度 2/5 1〜3時間 初心者へのやさしさ 85/100
githubnext/gh-aw-workshop#5193 ·
メンテナーはふだん 1 日以内に返信
-
[oblt-aw][autodoc] Document new required `shared-org-key` input for `obs-aw-dependency-review`対応中かも @github-actions が今日担当しました。 オープン
難易度 1/5 1時間未満 初心者へのやさしさ 90/100
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 62/100
calcit-lang/caps#16 ·
-
agent bug
難易度 1/5 1時間未満 初心者へのやさしさ 88/100