-
Story
-
Resolution: Unresolved
-
Undefined
-
None
-
rhel-cle-pni
-
-
-
*As a Fedora Forge user,*
I want clear and accurate documentation about HTTP authentication,
so that I can successfully authenticate with Git using the correct credentials without confusion.
-
- Background
The current HTTP authentication documentation at https://docs.fedoraproject.org/en-US/forge-documentation/using_http_auth/ contains unclear information that can lead to user confusion and authentication failures. Specifically, the documentation needs to clarify that:
1. Users enter an *access token* at the CLI, not a password
2. The username should be their *Fedora Accounts username*, not their Fedora Forge username
-
- Current Issues
-
-
- Issue 1: Password vs Token Confusion
-
- Documentation mentions "password" in several places when referring to access tokens
- Users may try to use their Fedora Account password instead of the access token
- CLI prompts show "Password:" (which we cannot change), so documentation warnings need to be more prominent
-
-
- Issue 2: Username Consistency
-
- Documentation inconsistently uses "Fedora Forge username"
- Should consistently use "Fedora Accounts username" for clarity and consistency