Skip to content

feat(ssh-guide): add SSH authentication guide for Git and servers#40

Merged
KemingHe merged 2 commits into
mainfrom
feat/ssh-guide/KemingHe
Feb 6, 2026
Merged

feat(ssh-guide): add SSH authentication guide for Git and servers#40
KemingHe merged 2 commits into
mainfrom
feat/ssh-guide/KemingHe

Conversation

@KemingHe
Copy link
Copy Markdown
Owner

@KemingHe KemingHe commented Feb 6, 2026

closes #33

CHANGES

  • SSH Authentication Guide (new)
    • Full workflow: check keys, generate Ed25519, add to ssh-agent
    • Use Case: Git hosting with URL rewriting (HTTPS URLs, SSH auth)
    • Use Case: Remote servers with ssh-copy-id and SCP file transfer
    • Troubleshooting: permission denied, agent persistence
  • CONTRIBUTING.md
    • Add Prerequisites section requiring SSH and GPG setup
    • Bump version to v2.2.0
  • SECURITY.md
    • Add Development Security section with CIA triad table
    • Bump version to v1.1.0
  • README.md
    • Add SSH to workflows list
  • human-guides/README.md
    • Add SSH guide to Use Cases list

IMPACT

  • Contributors now required to have SSH and GPG configured
  • Security guidance includes development workflow best practices

closes #33

CHANGES
- SSH Authentication Guide (new)
  - Full workflow: check keys, generate Ed25519, add to ssh-agent
  - Use Case: Git hosting with URL rewriting (HTTPS URLs, SSH auth)
  - Use Case: Remote servers with ssh-copy-id and SCP file transfer
  - Troubleshooting: permission denied, agent persistence
- CONTRIBUTING.md
  - Add Prerequisites section requiring SSH and GPG setup
  - Bump version to v2.2.0
- SECURITY.md
  - Add Development Security section with CIA triad table
  - Bump version to v1.1.0
- README.md
  - Add SSH to workflows list
- human-guides/README.md
  - Add SSH guide to Use Cases list

IMPACT
- Contributors now required to have SSH and GPG configured
- Security guidance includes development workflow best practices
@KemingHe KemingHe requested a review from Copilot February 6, 2026 19:43
@KemingHe KemingHe self-assigned this Feb 6, 2026
@KemingHe KemingHe added documentation Improvements or additions to documentation enhancement New feature or request labels Feb 6, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds an SSH authentication human guide and wires it into the repository’s contributor/security documentation so contributors can follow a consistent SSH + GPG workflow.

Changes:

  • Added a new SSH authentication guide covering key generation, ssh-agent usage, Git URL rewriting, server auth, and troubleshooting.
  • Updated contributor/security docs to reference SSH + GPG setup, and bumped guide/policy versions accordingly.
  • Updated indexes (root README and human-guides/README.md) to include the new SSH guide.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
human-guides/use-cases-ssh-authentication.md New end-to-end SSH authentication workflow guide (Git hosting + remote servers).
human-guides/use-cases-gpg-commit-signing.md Updates GitHub “Add GPG key” steps and bumps guide version.
human-guides/README.md Adds the SSH guide to the human-guides index.
SECURITY.md Adds “Development Security” section referencing SSH/GPG guides and bumps policy version.
README.md Includes SSH in the top-level workflows list.
CONTRIBUTING.md Adds prerequisites requiring SSH + GPG setup and bumps contributing guide version.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread SECURITY.md
Comment thread human-guides/use-cases-gpg-commit-signing.md Outdated
CHANGES
- SECURITY.md: add Availability row to CIA table (Git version control)
- GPG guide: add missing "paste public key" step in Add to GitHub
- SSH guide: update title example for consistency
@KemingHe KemingHe merged commit c60ee6f into main Feb 6, 2026
1 check passed
@KemingHe KemingHe deleted the feat/ssh-guide/KemingHe branch February 6, 2026 19:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat(ssh-guide): add use cases for generating, uploading, and authenticating to GitHub with SSH keys

2 participants