From 9a0a0335d66c8fbdcf0435b37835dd988f883e25 Mon Sep 17 00:00:00 2001 From: Waldir Pimenta Date: Wed, 21 Dec 2016 22:55:12 +0000 Subject: [PATCH] hub: overhaul the page for improved clarity (#1202) - make main description and command descriptions more specific - simplify the fork command description - simplify the pull-request example (both the command and description) hopefully without sacrificing information - replace the browse issues example (which opens a page in the web browser) with one create a github remote for the current repo --- pages/common/hub.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/pages/common/hub.md b/pages/common/hub.md index f18697d7ac..fb35c624ad 100644 --- a/pages/common/hub.md +++ b/pages/common/hub.md @@ -1,24 +1,24 @@ # hub -> A command-line wrapper for git that makes you better at GitHub. +> A wrapper for git that adds commands for working with github-based projects. > The commands can also be used using "git" instead of "hub". -- Clone a repository you own: +- Clone a repository you own, using just the repository name rather than the full URL: `hub clone {{repo_name}}` -- Clone another user's repository: +- Clone another user's repository, using their github username and the repository name: -`hub clone {{github_username}}/{{repo_name}}` +`hub clone {{username}}/{{repo_name}}` -- Fork your own copy of a repository cloned from another user (must be in the cloned repository folder, creates a remote named after your GitHub username): +- Create a fork of the current repository (cloned directly from another user) under your github profile: `hub fork` -- Create a pull request from your fork (first pushing the changes to your fork remote, named after your GitHub username): +- Create a pull request of the current branch in the upstream project (after sending the changes to your fork on github): -`git push {{your_github_username}} {{current_branch}} && hub pull-request` +`hub pull-request` -- Open the current project's issues page: +- Upload the current repository to your github account: -`hub browse -- issues` +`hub create`