{"action":"created","comment":{"url":"https://api.github.com/repos/giantswarm/inago/pulls/comments/57138711","id":57138711,"diff_hunk":"@@ -10,17 +12,42 @@ the user can manage a group more easily. Having this given, a group can be\n treated like a single unit. All actions one can apply to a unit using\n `fleetctl`, can also be applied towards a group using `inagoctl`.\n \n+There are two types of groups: slice groups and instance groups. Unit files,\n+which contain an `@` sign are considered sliceable. If the unit files does **not**\n+contain an `@` sign the unit is recognized an instance unit.\n+\n+Examples:\n+\n+### Sliceable group\n+\n+```nohighlight\n+└── mygroup\n+    ├── mygroup-bar@.service\n+    └── mygroup-foo@.service\n+```\n+\n+### Instance group\n+\n+```nohighlight\n+└── timer\n+    ├── timer-example.service\n+    └── timer-example.timer\n+```\n+\n+For more examples take a look at the example in the\n+[example folder](https://github.com/giantswarm/inago/tree/master/example).\n+\n A group is named after the directory its unit files live in. Having two units\n `mygroup-foo@.service` and `mygroup-bar@.timer` in the directory `mygroup`,\n leads to the Inago group `mygroup`. So creating a directory and putting units\n into it, creates a new group as Ingao is able to understand it.\n \n-### Slice\n+## Slice\n A slice is a scalable group instance. The kubernetes equivalent would be a\n replica. Slices are a scaled version of a group. So you can scale up your group\n using slice expansion. See also [What is slice expansion?](slice_expansion.md).\n \n-### Instance\n-A group instance is a group in a fleet cluster. Having a group definition on\n-your local file system and deploying this using Inago to a fleet cluster,\n-creates a group instance. This group instance may be one of multiple slices.\n+## Instance\n+A group instance is a group, which can **not** be scaled. Unit files which","path":"docs/terminology.md","position":56,"original_position":56,"commit_id":"2465250866704a101b20c882be43274f9235437d","original_commit_id":"2465250866704a101b20c882be43274f9235437d","user":{"login":"JosephSalisbury","id":297653,"avatar_url":"https://avatars.githubusercontent.com/u/297653?v=3","gravatar_id":"","url":"https://api.github.com/users/JosephSalisbury","html_url":"https://github.com/JosephSalisbury","followers_url":"https://api.github.com/users/JosephSalisbury/followers","following_url":"https://api.github.com/users/JosephSalisbury/following{/other_user}","gists_url":"https://api.github.com/users/JosephSalisbury/gists{/gist_id}","starred_url":"https://api.github.com/users/JosephSalisbury/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/JosephSalisbury/subscriptions","organizations_url":"https://api.github.com/users/JosephSalisbury/orgs","repos_url":"https://api.github.com/users/JosephSalisbury/repos","events_url":"https://api.github.com/users/JosephSalisbury/events{/privacy}","received_events_url":"https://api.github.com/users/JosephSalisbury/received_events","type":"User","site_admin":false},"body":"Remove the comma after \"group\"","created_at":"2016-03-23T10:41:32Z","updated_at":"2016-03-23T10:41:32Z","html_url":"https://github.com/giantswarm/inago/pull/173#discussion_r57138711","pull_request_url":"https://api.github.com/repos/giantswarm/inago/pulls/173","_links":{"self":{"href":"https://api.github.com/repos/giantswarm/inago/pulls/comments/57138711"},"html":{"href":"https://github.com/giantswarm/inago/pull/173#discussion_r57138711"},"pull_request":{"href":"https://api.github.com/repos/giantswarm/inago/pulls/173"}}},"pull_request":{"url":"https://api.github.com/repos/giantswarm/inago/pulls/173","id":63851023,"html_url":"https://github.com/giantswarm/inago/pull/173","diff_url":"https://github.com/giantswarm/inago/pull/173.diff","patch_url":"https://github.com/giantswarm/inago/pull/173.patch","issue_url":"https://api.github.com/repos/giantswarm/inago/issues/173","number":173,"state":"open","locked":false,"title":"Docs update","user":{"login":"puja108","id":5468872,"avatar_url":"https://avatars.githubusercontent.com/u/5468872?v=3","gravatar_id":"","url":"https://api.github.com/users/puja108","html_url":"https://github.com/puja108","followers_url":"https://api.github.com/users/puja108/followers","following_url":"https://api.github.com/users/puja108/following{/other_user}","gists_url":"https://api.github.com/users/puja108/gists{/gist_id}","starred_url":"https://api.github.com/users/puja108/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/puja108/subscriptions","organizations_url":"https://api.github.com/users/puja108/orgs","repos_url":"https://api.github.com/users/puja108/repos","events_url":"https://api.github.com/users/puja108/events{/privacy}","received_events_url":"https://api.github.com/users/puja108/received_events","type":"User","site_admin":false},"body":"revamping docs for structure and adding new content","created_at":"2016-03-23T09:15:31Z","updated_at":"2016-03-23T10:41:32Z","closed_at":null,"merged_at":null,"merge_commit_sha":"5aa3fd23fc87fb7607f23348590d3c61d3e866f4","assignee":{"login":"puja108","id":5468872,"avatar_url":"https://avatars.githubusercontent.com/u/5468872?v=3","gravatar_id":"","url":"https://api.github.com/users/puja108","html_url":"https://github.com/puja108","followers_url":"https://api.github.com/users/puja108/followers","following_url":"https://api.github.com/users/puja108/following{/other_user}","gists_url":"https://api.github.com/users/puja108/gists{/gist_id}","starred_url":"https://api.github.com/users/puja108/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/puja108/subscriptions","organizations_url":"https://api.github.com/users/puja108/orgs","repos_url":"https://api.github.com/users/puja108/repos","events_url":"https://api.github.com/users/puja108/events{/privacy}","received_events_url":"https://api.github.com/users/puja108/received_events","type":"User","site_admin":false},"milestone":null,"commits_url":"https://api.github.com/repos/giantswarm/inago/pulls/173/commits","review_comments_url":"https://api.github.com/repos/giantswarm/inago/pulls/173/comments","review_comment_url":"https://api.github.com/repos/giantswarm/inago/pulls/comments{/number}","comments_url":"https://api.github.com/repos/giantswarm/inago/issues/173/comments","statuses_url":"https://api.github.com/repos/giantswarm/inago/statuses/2465250866704a101b20c882be43274f9235437d","head":{"label":"giantswarm:docs-update","ref":"docs-update","sha":"2465250866704a101b20c882be43274f9235437d","user":{"login":"giantswarm","id":7556340,"avatar_url":"https://avatars.githubusercontent.com/u/7556340?v=3","gravatar_id":"","url":"https://api.github.com/users/giantswarm","html_url":"https://github.com/giantswarm","followers_url":"https://api.github.com/users/giantswarm/followers","following_url":"https://api.github.com/users/giantswarm/following{/other_user}","gists_url":"https://api.github.com/users/giantswarm/gists{/gist_id}","starred_url":"https://api.github.com/users/giantswarm/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/giantswarm/subscriptions","organizations_url":"https://api.github.com/users/giantswarm/orgs","repos_url":"https://api.github.com/users/giantswarm/repos","events_url":"https://api.github.com/users/giantswarm/events{/privacy}","received_events_url":"https://api.github.com/users/giantswarm/received_events","type":"Organization","site_admin":false},"repo":{"id":47976080,"name":"inago","full_name":"giantswarm/inago","owner":{"login":"giantswarm","id":7556340,"avatar_url":"https://avatars.githubusercontent.com/u/7556340?v=3","gravatar_id":"","url":"https://api.github.com/users/giantswarm","html_url":"https://github.com/giantswarm","followers_url":"https://api.github.com/users/giantswarm/followers","following_url":"https://api.github.com/users/giantswarm/following{/other_user}","gists_url":"https://api.github.com/users/giantswarm/gists{/gist_id}","starred_url":"https://api.github.com/users/giantswarm/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/giantswarm/subscriptions","organizations_url":"https://api.github.com/users/giantswarm/orgs","repos_url":"https://api.github.com/users/giantswarm/repos","events_url":"https://api.github.com/users/giantswarm/events{/privacy}","received_events_url":"https://api.github.com/users/giantswarm/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/giantswarm/inago","description":"Inago orchestrates groups of units on fleet clusters","fork":false,"url":"https://api.github.com/repos/giantswarm/inago","forks_url":"https://api.github.com/repos/giantswarm/inago/forks","keys_url":"https://api.github.com/repos/giantswarm/inago/keys{/key_id}","collaborators_url":"https://api.github.com/repos/giantswarm/inago/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/giantswarm/inago/teams","hooks_url":"https://api.github.com/repos/giantswarm/inago/hooks","issue_events_url":"https://api.github.com/repos/giantswarm/inago/issues/events{/number}","events_url":"https://api.github.com/repos/giantswarm/inago/events","assignees_url":"https://api.github.com/repos/giantswarm/inago/assignees{/user}","branches_url":"https://api.github.com/repos/giantswarm/inago/branches{/branch}","tags_url":"https://api.github.com/repos/giantswarm/inago/tags","blobs_url":"https://api.github.com/repos/giantswarm/inago/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/giantswarm/inago/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/giantswarm/inago/git/refs{/sha}","trees_url":"https://api.github.com/repos/giantswarm/inago/git/trees{/sha}","statuses_url":"https://api.github.com/repos/giantswarm/inago/statuses/{sha}","languages_url":"https://api.github.com/repos/giantswarm/inago/languages","stargazers_url":"https://api.github.com/repos/giantswarm/inago/stargazers","contributors_url":"https://api.github.com/repos/giantswarm/inago/contributors","subscribers_url":"https://api.github.com/repos/giantswarm/inago/subscribers","subscription_url":"https://api.github.com/repos/giantswarm/inago/subscription","commits_url":"https://api.github.com/repos/giantswarm/inago/commits{/sha}","git_commits_url":"https://api.github.com/repos/giantswarm/inago/git/commits{/sha}","comments_url":"https://api.github.com/repos/giantswarm/inago/comments{/number}","issue_comment_url":"https://api.github.com/repos/giantswarm/inago/issues/comments{/number}","contents_url":"https://api.github.com/repos/giantswarm/inago/contents/{+path}","compare_url":"https://api.github.com/repos/giantswarm/inago/compare/{base}...{head}","merges_url":"https://api.github.com/repos/giantswarm/inago/merges","archive_url":"https://api.github.com/repos/giantswarm/inago/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/giantswarm/inago/downloads","issues_url":"https://api.github.com/repos/giantswarm/inago/issues{/number}","pulls_url":"https://api.github.com/repos/giantswarm/inago/pulls{/number}","milestones_url":"https://api.github.com/repos/giantswarm/inago/milestones{/number}","notifications_url":"https://api.github.com/repos/giantswarm/inago/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/giantswarm/inago/labels{/name}","releases_url":"https://api.github.com/repos/giantswarm/inago/releases{/id}","deployments_url":"https://api.github.com/repos/giantswarm/inago/deployments","created_at":"2015-12-14T13:16:06Z","updated_at":"2016-03-23T10:18:34Z","pushed_at":"2016-03-23T10:21:44Z","git_url":"git://github.com/giantswarm/inago.git","ssh_url":"git@github.com:giantswarm/inago.git","clone_url":"https://github.com/giantswarm/inago.git","svn_url":"https://github.com/giantswarm/inago","homepage":"https://giantswarm.io/","size":460,"stargazers_count":4,"watchers_count":4,"language":"Go","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":33,"forks":0,"open_issues":33,"watchers":4,"default_branch":"master"}},"base":{"label":"giantswarm:master","ref":"master","sha":"10db209ca45aaf29c65f3c091b0ca8624a780971","user":{"login":"giantswarm","id":7556340,"avatar_url":"https://avatars.githubusercontent.com/u/7556340?v=3","gravatar_id":"","url":"https://api.github.com/users/giantswarm","html_url":"https://github.com/giantswarm","followers_url":"https://api.github.com/users/giantswarm/followers","following_url":"https://api.github.com/users/giantswarm/following{/other_user}","gists_url":"https://api.github.com/users/giantswarm/gists{/gist_id}","starred_url":"https://api.github.com/users/giantswarm/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/giantswarm/subscriptions","organizations_url":"https://api.github.com/users/giantswarm/orgs","repos_url":"https://api.github.com/users/giantswarm/repos","events_url":"https://api.github.com/users/giantswarm/events{/privacy}","received_events_url":"https://api.github.com/users/giantswarm/received_events","type":"Organization","site_admin":false},"repo":{"id":47976080,"name":"inago","full_name":"giantswarm/inago","owner":{"login":"giantswarm","id":7556340,"avatar_url":"https://avatars.githubusercontent.com/u/7556340?v=3","gravatar_id":"","url":"https://api.github.com/users/giantswarm","html_url":"https://github.com/giantswarm","followers_url":"https://api.github.com/users/giantswarm/followers","following_url":"https://api.github.com/users/giantswarm/following{/other_user}","gists_url":"https://api.github.com/users/giantswarm/gists{/gist_id}","starred_url":"https://api.github.com/users/giantswarm/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/giantswarm/subscriptions","organizations_url":"https://api.github.com/users/giantswarm/orgs","repos_url":"https://api.github.com/users/giantswarm/repos","events_url":"https://api.github.com/users/giantswarm/events{/privacy}","received_events_url":"https://api.github.com/users/giantswarm/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/giantswarm/inago","description":"Inago orchestrates groups of units on fleet clusters","fork":false,"url":"https://api.github.com/repos/giantswarm/inago","forks_url":"https://api.github.com/repos/giantswarm/inago/forks","keys_url":"https://api.github.com/repos/giantswarm/inago/keys{/key_id}","collaborators_url":"https://api.github.com/repos/giantswarm/inago/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/giantswarm/inago/teams","hooks_url":"https://api.github.com/repos/giantswarm/inago/hooks","issue_events_url":"https://api.github.com/repos/giantswarm/inago/issues/events{/number}","events_url":"https://api.github.com/repos/giantswarm/inago/events","assignees_url":"https://api.github.com/repos/giantswarm/inago/assignees{/user}","branches_url":"https://api.github.com/repos/giantswarm/inago/branches{/branch}","tags_url":"https://api.github.com/repos/giantswarm/inago/tags","blobs_url":"https://api.github.com/repos/giantswarm/inago/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/giantswarm/inago/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/giantswarm/inago/git/refs{/sha}","trees_url":"https://api.github.com/repos/giantswarm/inago/git/trees{/sha}","statuses_url":"https://api.github.com/repos/giantswarm/inago/statuses/{sha}","languages_url":"https://api.github.com/repos/giantswarm/inago/languages","stargazers_url":"https://api.github.com/repos/giantswarm/inago/stargazers","contributors_url":"https://api.github.com/repos/giantswarm/inago/contributors","subscribers_url":"https://api.github.com/repos/giantswarm/inago/subscribers","subscription_url":"https://api.github.com/repos/giantswarm/inago/subscription","commits_url":"https://api.github.com/repos/giantswarm/inago/commits{/sha}","git_commits_url":"https://api.github.com/repos/giantswarm/inago/git/commits{/sha}","comments_url":"https://api.github.com/repos/giantswarm/inago/comments{/number}","issue_comment_url":"https://api.github.com/repos/giantswarm/inago/issues/comments{/number}","contents_url":"https://api.github.com/repos/giantswarm/inago/contents/{+path}","compare_url":"https://api.github.com/repos/giantswarm/inago/compare/{base}...{head}","merges_url":"https://api.github.com/repos/giantswarm/inago/merges","archive_url":"https://api.github.com/repos/giantswarm/inago/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/giantswarm/inago/downloads","issues_url":"https://api.github.com/repos/giantswarm/inago/issues{/number}","pulls_url":"https://api.github.com/repos/giantswarm/inago/pulls{/number}","milestones_url":"https://api.github.com/repos/giantswarm/inago/milestones{/number}","notifications_url":"https://api.github.com/repos/giantswarm/inago/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/giantswarm/inago/labels{/name}","releases_url":"https://api.github.com/repos/giantswarm/inago/releases{/id}","deployments_url":"https://api.github.com/repos/giantswarm/inago/deployments","created_at":"2015-12-14T13:16:06Z","updated_at":"2016-03-23T10:18:34Z","pushed_at":"2016-03-23T10:21:44Z","git_url":"git://github.com/giantswarm/inago.git","ssh_url":"git@github.com:giantswarm/inago.git","clone_url":"https://github.com/giantswarm/inago.git","svn_url":"https://github.com/giantswarm/inago","homepage":"https://giantswarm.io/","size":460,"stargazers_count":4,"watchers_count":4,"language":"Go","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":33,"forks":0,"open_issues":33,"watchers":4,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/giantswarm/inago/pulls/173"},"html":{"href":"https://github.com/giantswarm/inago/pull/173"},"issue":{"href":"https://api.github.com/repos/giantswarm/inago/issues/173"},"comments":{"href":"https://api.github.com/repos/giantswarm/inago/issues/173/comments"},"review_comments":{"href":"https://api.github.com/repos/giantswarm/inago/pulls/173/comments"},"review_comment":{"href":"https://api.github.com/repos/giantswarm/inago/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/giantswarm/inago/pulls/173/commits"},"statuses":{"href":"https://api.github.com/repos/giantswarm/inago/statuses/2465250866704a101b20c882be43274f9235437d"}}}}