GitHub PullRequestReviewCommentEvent at 2014-12-15 15:37:20
Repository: git-town
Actor: charlierudolph
Payload: {"action":"created","comment":{"url":"https://api.github.com/repos/Originate/git-town/pulls/comments/21832671","id":21832671,"diff_hunk":"@@ -1,40 +1,65 @@\n .TH \"GIT-TOWN\" \"1\" \"12/02/2014\" \"Git Town 0\\&.4\\&.1\" \"Git Town Manual\"\n \n-.SH \"DESCRIPTION\"\n-Git Town is a collection of additional Git commands that help implement\n-higher-level Git workflows like GitHub flow:\n+.SH \"SYNOPSIS\"\n+\\fIgit town\\fR config\n .br\n-(\\fIhttp://guides.github.com/introduction/flow/index.html\\fR)\n-\n-For more information, please visit\n+\\fIgit town\\fR help\n+.br\n+\\fIgit town\\fR main-branch [<branchname>]\n .br\n-\\fihttps://github.com/Originate/git-town\\fR\n+\\fIgit town\\fR non-feature-branches [--add|--remove [<branchname>]]\n+.br\n+\\fIgit town\\fR version\n+\n+\n+.SH \"DESCRIPTION\"\n+Git Town is a collection of additional Git commands that help implement higher-level Git workflows like GitHub Flow.\n+\n+For more information and full documentation, please visit: \\fihttps://github.com/Originate/git-town\\fR\n+\n \n .SH \"COMMANDS\"\n+\\fBgit extract\\fR         Copy selected commits from the current branch into their own branch\n+.br\n+\\fBgit hack\\fR            Cut a new feature branch off the main branch\n+.br\n+\\fBgit kill\\fR            Remove an obsolete feature branch\n+.br\n+\\fBgit pr\\fR              Create a new pull request\n+.br\n+\\fBgit prune-branches\\fR  Delete merged branches\n+.br\n+\\fBgit repo\\fR            View the repository homepage\n+.br\n+\\fBgit ship\\fR            Deliver a completed feature branch\n+.br\n+\\fBgit sync\\fR            Update the current branch with all relevant changes\n+.br\n+\\fBgit sync-fork\\fR       Pull upstream updates into a forked repository\n+\n+All commands listed here support the '--help' flag.\n \n-.B git extract\n-- copy selected commits from the current branch into their own branch\n \n-.B git hack\n-- cut a new feature branch off the main branch\n+.SH \"CONFIGURATION\"\n+Git Town will automatically prompt you for the main and non-feature branches\n+of your current repository if they haven't been set.\n \n-.B git kill\n-- remove an obsolete feature branch\n+You may also manually view and modify the configurations:\n \n-.B git pr\n-- create a new pull request\n+.IP \"git town config\" 4\n+View your current Git Town configuration\n \n-.B git prune-branches\n-- delete merged branches\n+.IP \"git town main-branch\" 4\n+View just your main branch configuration\n \n-.B git repo\n-- view the repository homepage\n+.IP \"git town main-branch <branchname>\" 4\n+Set your main branch to <branchname>\n \n-.B git ship\n-- deliver a completed feature branch\n+.IP \"git town non-feature-branches\" 4\n+View just your non-feature branches\n \n-.B git sync\n-- update the current branch with all relevant changes\n+.IP \"git town non-feature-branches --add <branchname>\" 4\n+Add a new non-feature branch\n \n-.B git sync-fork\n-- pull upstream updates into a forked repository\n+.IP \"git town non-feature-branches --remove <branchname>\" 4\n+Remove branch from non-feature branches","path":"man/man1/git-town.1","position":90,"original_position":90,"commit_id":"dbe9b7a53370f384de033b69b64aacc3a518503e","original_commit_id":"5b53756b60c84dd84cf0f3ffd144556dd56bef68","user":{"login":"charlierudolph","id":1676758,"avatar_url":"https://avatars.githubusercontent.com/u/1676758?v=3","gravatar_id":"","url":"https://api.github.com/users/charlierudolph","html_url":"https://github.com/charlierudolph","followers_url":"https://api.github.com/users/charlierudolph/followers","following_url":"https://api.github.com/users/charlierudolph/following{/other_user}","gists_url":"https://api.github.com/users/charlierudolph/gists{/gist_id}","starred_url":"https://api.github.com/users/charlierudolph/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/charlierudolph/subscriptions","organizations_url":"https://api.github.com/users/charlierudolph/orgs","repos_url":"https://api.github.com/users/charlierudolph/repos","events_url":"https://api.github.com/users/charlierudolph/events{/privacy}","received_events_url":"https://api.github.com/users/charlierudolph/received_events","type":"User","site_admin":false},"body":"The sections I suggested are following git's example if you look at the git man page.","created_at":"2014-12-15T15:37:20Z","updated_at":"2014-12-15T15:37:20Z","html_url":"https://github.com/Originate/git-town/pull/234#discussion_r21832671","pull_request_url":"https://api.github.com/repos/Originate/git-town/pulls/234","_links":{"self":{"href":"https://api.github.com/repos/Originate/git-town/pulls/comments/21832671"},"html":{"href":"https://github.com/Originate/git-town/pull/234#discussion_r21832671"},"pull_request":{"href":"https://api.github.com/repos/Originate/git-town/pulls/234"}}},"pull_request":{"url":"https://api.github.com/repos/Originate/git-town/pulls/234","id":25650366,"html_url":"https://github.com/Originate/git-town/pull/234","diff_url":"https://github.com/Originate/git-town/pull/234.diff","patch_url":"https://github.com/Originate/git-town/pull/234.patch","issue_url":"https://api.github.com/repos/Originate/git-town/issues/234","number":234,"state":"open","locked":false,"title":"Finish implementing #98 (encapsulate configuration)","user":{"login":"allewun","id":1256911,"avatar_url":"https://avatars.githubusercontent.com/u/1256911?v=3","gravatar_id":"","url":"https://api.github.com/users/allewun","html_url":"https://github.com/allewun","followers_url":"https://api.github.com/users/allewun/followers","following_url":"https://api.github.com/users/allewun/following{/other_user}","gists_url":"https://api.github.com/users/allewun/gists{/gist_id}","starred_url":"https://api.github.com/users/allewun/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/allewun/subscriptions","organizations_url":"https://api.github.com/users/allewun/orgs","repos_url":"https://api.github.com/users/allewun/repos","events_url":"https://api.github.com/users/allewun/events{/privacy}","received_events_url":"https://api.github.com/users/allewun/received_events","type":"User","site_admin":false},"body":"@charlierudolph @kevgo \r\n\r\n* Added ability to run `git town [...]` even before configuring git town.\r\n  * Rationale - the user should be able to see the help text before being immediately prompted by the config prompts\r\n* Added `git town main-branch [<branch_name>]` to view and edit the main branch\r\n* Added `git town non-feature-branches [--add|--remove <branch_name>]` to view and modify non-feature branches\r\n\r\nCouple issues:\r\n* the linter on Travis seems to be different from the one I have. Everything passes locally, but Travis' wants me to fix [line 42 of shell_helpers.sh](https://github.com/Originate/git-town/compare/aw-finish-config?expand=1#diff-5fb3dd355b9b26c61663d7e067c373fbR42). Following their suggestion, the functionality seems to change and break.\r\n* The `git town` \"option parsing\" seems messy -- any advice?\r\n* Don't really like the differences between the flags and \"subcommands\", e.g. `git town main-branch` vs. `git town --config`. Would `git town config` be better than `git town --config` (per Kevin's original suggestion)?","created_at":"2014-12-08T07:53:59Z","updated_at":"2014-12-15T15:37:20Z","closed_at":null,"merged_at":null,"merge_commit_sha":"17cb0b06f19019ec93800c77edee3ed263a0f973","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/Originate/git-town/pulls/234/commits","review_comments_url":"https://api.github.com/repos/Originate/git-town/pulls/234/comments","review_comment_url":"https://api.github.com/repos/Originate/git-town/pulls/comments/{number}","comments_url":"https://api.github.com/repos/Originate/git-town/issues/234/comments","statuses_url":"https://api.github.com/repos/Originate/git-town/statuses/dbe9b7a53370f384de033b69b64aacc3a518503e","head":{"label":"Originate:aw-finish-config","ref":"aw-finish-config","sha":"dbe9b7a53370f384de033b69b64aacc3a518503e","user":{"login":"Originate","id":1627168,"avatar_url":"https://avatars.githubusercontent.com/u/1627168?v=3","gravatar_id":"","url":"https://api.github.com/users/Originate","html_url":"https://github.com/Originate","followers_url":"https://api.github.com/users/Originate/followers","following_url":"https://api.github.com/users/Originate/following{/other_user}","gists_url":"https://api.github.com/users/Originate/gists{/gist_id}","starred_url":"https://api.github.com/users/Originate/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Originate/subscriptions","organizations_url":"https://api.github.com/users/Originate/orgs","repos_url":"https://api.github.com/users/Originate/repos","events_url":"https://api.github.com/users/Originate/events{/privacy}","received_events_url":"https://api.github.com/users/Originate/received_events","type":"Organization","site_admin":false},"repo":{"id":19825320,"name":"git-town","full_name":"Originate/git-town","owner":{"login":"Originate","id":1627168,"avatar_url":"https://avatars.githubusercontent.com/u/1627168?v=3","gravatar_id":"","url":"https://api.github.com/users/Originate","html_url":"https://github.com/Originate","followers_url":"https://api.github.com/users/Originate/followers","following_url":"https://api.github.com/users/Originate/following{/other_user}","gists_url":"https://api.github.com/users/Originate/gists{/gist_id}","starred_url":"https://api.github.com/users/Originate/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Originate/subscriptions","organizations_url":"https://api.github.com/users/Originate/orgs","repos_url":"https://api.github.com/users/Originate/repos","events_url":"https://api.github.com/users/Originate/events{/privacy}","received_events_url":"https://api.github.com/users/Originate/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/Originate/git-town","description":"Hackable Git extensions for team-based Git workflows","fork":false,"url":"https://api.github.com/repos/Originate/git-town","forks_url":"https://api.github.com/repos/Originate/git-town/forks","keys_url":"https://api.github.com/repos/Originate/git-town/keys{/key_id}","collaborators_url":"https://api.github.com/repos/Originate/git-town/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/Originate/git-town/teams","hooks_url":"https://api.github.com/repos/Originate/git-town/hooks","issue_events_url":"https://api.github.com/repos/Originate/git-town/issues/events{/number}","events_url":"https://api.github.com/repos/Originate/git-town/events","assignees_url":"https://api.github.com/repos/Originate/git-town/assignees{/user}","branches_url":"https://api.github.com/repos/Originate/git-town/branches{/branch}","tags_url":"https://api.github.com/repos/Originate/git-town/tags","blobs_url":"https://api.github.com/repos/Originate/git-town/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/Originate/git-town/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/Originate/git-town/git/refs{/sha}","trees_url":"https://api.github.com/repos/Originate/git-town/git/trees{/sha}","statuses_url":"https://api.github.com/repos/Originate/git-town/statuses/{sha}","languages_url":"https://api.github.com/repos/Originate/git-town/languages","stargazers_url":"https://api.github.com/repos/Originate/git-town/stargazers","contributors_url":"https://api.github.com/repos/Originate/git-town/contributors","subscribers_url":"https://api.github.com/repos/Originate/git-town/subscribers","subscription_url":"https://api.github.com/repos/Originate/git-town/subscription","commits_url":"https://api.github.com/repos/Originate/git-town/commits{/sha}","git_commits_url":"https://api.github.com/repos/Originate/git-town/git/commits{/sha}","comments_url":"https://api.github.com/repos/Originate/git-town/comments{/number}","issue_comment_url":"https://api.github.com/repos/Originate/git-town/issues/comments/{number}","contents_url":"https://api.github.com/repos/Originate/git-town/contents/{+path}","compare_url":"https://api.github.com/repos/Originate/git-town/compare/{base}...{head}","merges_url":"https://api.github.com/repos/Originate/git-town/merges","archive_url":"https://api.github.com/repos/Originate/git-town/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/Originate/git-town/downloads","issues_url":"https://api.github.com/repos/Originate/git-town/issues{/number}","pulls_url":"https://api.github.com/repos/Originate/git-town/pulls{/number}","milestones_url":"https://api.github.com/repos/Originate/git-town/milestones{/number}","notifications_url":"https://api.github.com/repos/Originate/git-town/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/Originate/git-town/labels{/name}","releases_url":"https://api.github.com/repos/Originate/git-town/releases{/id}","created_at":"2014-05-15T15:44:29Z","updated_at":"2014-12-15T05:35:33Z","pushed_at":"2014-12-15T15:36:18Z","git_url":"git://github.com/Originate/git-town.git","ssh_url":"git@github.com:Originate/git-town.git","clone_url":"https://github.com/Originate/git-town.git","svn_url":"https://github.com/Originate/git-town","homepage":"","size":6952,"stargazers_count":40,"watchers_count":40,"language":"Shell","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":1,"mirror_url":null,"open_issues_count":41,"forks":1,"open_issues":41,"watchers":40,"default_branch":"master"}},"base":{"label":"Originate:master","ref":"master","sha":"53debb0497ed533375be4a7d48acf567fe792f5b","user":{"login":"Originate","id":1627168,"avatar_url":"https://avatars.githubusercontent.com/u/1627168?v=3","gravatar_id":"","url":"https://api.github.com/users/Originate","html_url":"https://github.com/Originate","followers_url":"https://api.github.com/users/Originate/followers","following_url":"https://api.github.com/users/Originate/following{/other_user}","gists_url":"https://api.github.com/users/Originate/gists{/gist_id}","starred_url":"https://api.github.com/users/Originate/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Originate/subscriptions","organizations_url":"https://api.github.com/users/Originate/orgs","repos_url":"https://api.github.com/users/Originate/repos","events_url":"https://api.github.com/users/Originate/events{/privacy}","received_events_url":"https://api.github.com/users/Originate/received_events","type":"Organization","site_admin":false},"repo":{"id":19825320,"name":"git-town","full_name":"Originate/git-town","owner":{"login":"Originate","id":1627168,"avatar_url":"https://avatars.githubusercontent.com/u/1627168?v=3","gravatar_id":"","url":"https://api.github.com/users/Originate","html_url":"https://github.com/Originate","followers_url":"https://api.github.com/users/Originate/followers","following_url":"https://api.github.com/users/Originate/following{/other_user}","gists_url":"https://api.github.com/users/Originate/gists{/gist_id}","starred_url":"https://api.github.com/users/Originate/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Originate/subscriptions","organizations_url":"https://api.github.com/users/Originate/orgs","repos_url":"https://api.github.com/users/Originate/repos","events_url":"https://api.github.com/users/Originate/events{/privacy}","received_events_url":"https://api.github.com/users/Originate/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/Originate/git-town","description":"Hackable Git extensions for team-based Git workflows","fork":false,"url":"https://api.github.com/repos/Originate/git-town","forks_url":"https://api.github.com/repos/Originate/git-town/forks","keys_url":"https://api.github.com/repos/Originate/git-town/keys{/key_id}","collaborators_url":"https://api.github.com/repos/Originate/git-town/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/Originate/git-town/teams","hooks_url":"https://api.github.com/repos/Originate/git-town/hooks","issue_events_url":"https://api.github.com/repos/Originate/git-town/issues/events{/number}","events_url":"https://api.github.com/repos/Originate/git-town/events","assignees_url":"https://api.github.com/repos/Originate/git-town/assignees{/user}","branches_url":"https://api.github.com/repos/Originate/git-town/branches{/branch}","tags_url":"https://api.github.com/repos/Originate/git-town/tags","blobs_url":"https://api.github.com/repos/Originate/git-town/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/Originate/git-town/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/Originate/git-town/git/refs{/sha}","trees_url":"https://api.github.com/repos/Originate/git-town/git/trees{/sha}","statuses_url":"https://api.github.com/repos/Originate/git-town/statuses/{sha}","languages_url":"https://api.github.com/repos/Originate/git-town/languages","stargazers_url":"https://api.github.com/repos/Originate/git-town/stargazers","contributors_url":"https://api.github.com/repos/Originate/git-town/contributors","subscribers_url":"https://api.github.com/repos/Originate/git-town/subscribers","subscription_url":"https://api.github.com/repos/Originate/git-town/subscription","commits_url":"https://api.github.com/repos/Originate/git-town/commits{/sha}","git_commits_url":"https://api.github.com/repos/Originate/git-town/git/commits{/sha}","comments_url":"https://api.github.com/repos/Originate/git-town/comments{/number}","issue_comment_url":"https://api.github.com/repos/Originate/git-town/issues/comments/{number}","contents_url":"https://api.github.com/repos/Originate/git-town/contents/{+path}","compare_url":"https://api.github.com/repos/Originate/git-town/compare/{base}...{head}","merges_url":"https://api.github.com/repos/Originate/git-town/merges","archive_url":"https://api.github.com/repos/Originate/git-town/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/Originate/git-town/downloads","issues_url":"https://api.github.com/repos/Originate/git-town/issues{/number}","pulls_url":"https://api.github.com/repos/Originate/git-town/pulls{/number}","milestones_url":"https://api.github.com/repos/Originate/git-town/milestones{/number}","notifications_url":"https://api.github.com/repos/Originate/git-town/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/Originate/git-town/labels{/name}","releases_url":"https://api.github.com/repos/Originate/git-town/releases{/id}","created_at":"2014-05-15T15:44:29Z","updated_at":"2014-12-15T05:35:33Z","pushed_at":"2014-12-15T15:36:18Z","git_url":"git://github.com/Originate/git-town.git","ssh_url":"git@github.com:Originate/git-town.git","clone_url":"https://github.com/Originate/git-town.git","svn_url":"https://github.com/Originate/git-town","homepage":"","size":6952,"stargazers_count":40,"watchers_count":40,"language":"Shell","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":1,"mirror_url":null,"open_issues_count":41,"forks":1,"open_issues":41,"watchers":40,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/Originate/git-town/pulls/234"},"html":{"href":"https://github.com/Originate/git-town/pull/234"},"issue":{"href":"https://api.github.com/repos/Originate/git-town/issues/234"},"comments":{"href":"https://api.github.com/repos/Originate/git-town/issues/234/comments"},"review_comments":{"href":"https://api.github.com/repos/Originate/git-town/pulls/234/comments"},"review_comment":{"href":"https://api.github.com/repos/Originate/git-town/pulls/comments/{number}"},"commits":{"href":"https://api.github.com/repos/Originate/git-town/pulls/234/commits"},"statuses":{"href":"https://api.github.com/repos/Originate/git-town/statuses/dbe9b7a53370f384de033b69b64aacc3a518503e"}}}}