Skip to content

docs: add Git remotes authentication guide - #2454

Closed
emanuelpalaszewski wants to merge 1 commit into
git-ecosystem:mainfrom
emanuelpalaszewski:emanuelpalaszewski-clarify-git-remote-docs
Closed

emanuelpalaszewski wants to merge 1 commit into
git-ecosystem:mainfrom
emanuelpalaszewski:emanuelpalaszewski-clarify-git-remote-docs

Conversation

@emanuelpalaszewski

@emanuelpalaszewski emanuelpalaszewski commented Sep 20, 2026 •

Copy link
Copy Markdown

Why

Users need a concise, GCM-specific explanation of how HTTPS and SSH remotes differ and when GCM participates in authentication.

What changed

  • Added a guide covering HTTPS authentication through GCM, credential storage, token safety, SSH setup, and switching remote URLs.
  • Linked the guide from the documentation index.

Validation

  • git diff --check

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@emanuelpalaszewski
emanuelpalaszewski requested a review from a team as a code owner September 20, 2026 23:56

@dscho dscho left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I do not find this documentation particularly helpful, nor do I agree that GCM is the right spot for this documentation: This is about Git remotes, therefore it should be documented in Git. But then, the documentation is misleading in the first place because GCM kicks in as a credential helper, not only for remotes, but even for clones (where there is no remote yet) or for plain-URL fetches ("git fetch https://github.com/git-ecosystem-git-credential-manager main").

It doesn't help that this is the usual AI-generated verbose word soup.

tl;dr I would not merge this, nor any iteration thereof.

@emanuelpalaszewski
emanuelpalaszewski deleted the emanuelpalaszewski-clarify-git-remote-docs branch September 21, 2026 07:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants