Uploaded image for project: 'Community Linux Engineering'
  1. Community Linux Engineering
  2. CLE-1632

Clarify HTTP Authentication Documentation

    • 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.

        1. 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

        1. Current Issues
          1. 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
          1. Issue 2: Username Consistency
      • Documentation inconsistently uses "Fedora Forge username"
      • Should consistently use "Fedora Accounts username" for clarity and consistency

              rhn-engineering-nphilipp Nils Philippsen
              cle_bot CLE bot
              Votes:
              0 Vote for this issue
              Watchers:
              1 Start watching this issue

                Created:
                Updated: