{"action":"created","comment":{"url":"https://api.github.com/repos/jekyll/jekyll/pulls/comments/93796164","pull_request_review_id":14324060,"id":93796164,"diff_hunk":"@@ -530,13 +638,33 @@ site. If you use `linenos`, you might want to include an additional CSS class\n definition for the `.lineno` class in `syntax.css` to distinguish the line\n numbers from the highlighted code.\n \n-### Link\n+### Gist\n+\n+Use the `gist` tag to easily embed a GitHub Gist onto your site. This works","path":"docs/_docs/templates.md","position":199,"original_position":199,"commit_id":"834bb82c6042d485218feb2bb68677097b27c2d6","original_commit_id":"834bb82c6042d485218feb2bb68677097b27c2d6","user":{"login":"pathawks","id":251545,"avatar_url":"https://avatars.githubusercontent.com/u/251545?v=3","gravatar_id":"","url":"https://api.github.com/users/pathawks","html_url":"https://github.com/pathawks","followers_url":"https://api.github.com/users/pathawks/followers","following_url":"https://api.github.com/users/pathawks/following{/other_user}","gists_url":"https://api.github.com/users/pathawks/gists{/gist_id}","starred_url":"https://api.github.com/users/pathawks/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pathawks/subscriptions","organizations_url":"https://api.github.com/users/pathawks/orgs","repos_url":"https://api.github.com/users/pathawks/repos","events_url":"https://api.github.com/users/pathawks/events{/privacy}","received_events_url":"https://api.github.com/users/pathawks/received_events","type":"User","site_admin":false},"body":"I see this all was included before, you just moved it.\r\n\r\n:shrug:","created_at":"2016-12-23T19:28:02Z","updated_at":"2016-12-23T19:49:22Z","html_url":"https://github.com/jekyll/jekyll/pull/5630#discussion_r93796164","pull_request_url":"https://api.github.com/repos/jekyll/jekyll/pulls/5630","_links":{"self":{"href":"https://api.github.com/repos/jekyll/jekyll/pulls/comments/93796164"},"html":{"href":"https://github.com/jekyll/jekyll/pull/5630#discussion_r93796164"},"pull_request":{"href":"https://api.github.com/repos/jekyll/jekyll/pulls/5630"}}},"pull_request":{"url":"https://api.github.com/repos/jekyll/jekyll/pulls/5630","id":96425651,"html_url":"https://github.com/jekyll/jekyll/pull/5630","diff_url":"https://github.com/jekyll/jekyll/pull/5630.diff","patch_url":"https://github.com/jekyll/jekyll/pull/5630.patch","issue_url":"https://api.github.com/repos/jekyll/jekyll/issues/5630","number":5630,"state":"open","locked":false,"title":"Updates to permalink documentation","user":{"login":"tomjohnson1492","id":6385062,"avatar_url":"https://avatars.githubusercontent.com/u/6385062?v=3","gravatar_id":"","url":"https://api.github.com/users/tomjohnson1492","html_url":"https://github.com/tomjohnson1492","followers_url":"https://api.github.com/users/tomjohnson1492/followers","following_url":"https://api.github.com/users/tomjohnson1492/following{/other_user}","gists_url":"https://api.github.com/users/tomjohnson1492/gists{/gist_id}","starred_url":"https://api.github.com/users/tomjohnson1492/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tomjohnson1492/subscriptions","organizations_url":"https://api.github.com/users/tomjohnson1492/orgs","repos_url":"https://api.github.com/users/tomjohnson1492/repos","events_url":"https://api.github.com/users/tomjohnson1492/events{/privacy}","received_events_url":"https://api.github.com/users/tomjohnson1492/received_events","type":"User","site_admin":false},"body":"I reviewed the existing permalink documentation and made some updates to improve the clarity and accuracy. There are several pages that I updated in this pull request:\r\n\r\n**permalinks.** I heavily edited this page to be more thorough and cover some more scenarios. I don't think can just get a sense of my updates by reading the side-by-side comparison in the Github interface. I think you need to download the patch branch and build it locally to see the whole context.\r\n\r\n**collections.** I'm not sure if permalink details for collections belongs in the Collections topic or Permalinks topic, but I left it in Collections for now. I included a number of scenarios to clarify permalinks. Some details were just confusing (which you can see by reading this [Jekyll talk thread](https://talk.jekyllrb.com/t/how-can-i-change-the-filename-extension-from-html-to-xhtml/3341/8)).\r\n\r\n**pages.** Just made a few updates. One detail I think was outdated in the existed docs is the practice of manually inserting index.html files inside of folders. Using the right permalink styles makes this unnecessary. Really the update that started this whole pull request was the ability to flatten pages in root. I spent months trying all kinds of workarounds until I stumbled across this technique. \r\n\r\n(Overall, too much of the Jekyll documentation focuses on blogging scenarios. There is a huge trend of using Jekyll for documentation sites, so the emphasis on pages needs expansion. With doc sites, users don't just have a few pages. They potentially have hundreds, and the workflow is different. You often submit content to an internal environment before pushing it out live. In my doc contributions, I want to help expand the doc site scenario.)\r\n\r\n**templates.** No new updates here -- this is just the same content I changed and submitted in my previous pull request (https://github.com/jekyll/jekyll/pull/5610). If you process that pull request first, this should not show any conflicts. Or actually, you might want to close the previous pull request and just process this request. I provided more detail about using includes in a more advanced way. I tried to explain includes, especially passing parameters to includes, with more clarity.\r\n\r\n**quickstart.** I updated the quickstart page to provide more information about all the missing files and directories that people have been wondering about ever since the introduction of gem-based themes. I feel we really need this detail clarified in the quick start. I don't know how many questions I've seen in the forum where people ask where these files are, but it's a frequent question.\r\n\r\nAlso, I think given that Github Pages supports only Minima, there needs to be more emphasis on installing non-gem-based themes as well. \r\n\r\nI also explain what the Gemfile and Gemfile lock, as well as bundle exec commands, actually do, since these now come into play more prominently with gem-based themes.\r\n\r\n**.gitignore.** I use WebStorm to work with Jekyll. I need to omit the .idea files that WebStorm generates to index the content.\r\n\r\nI'd like to contribute a lot more to the documentation. If you want me to bounce ideas off you first in a more malleable space, like Google Docs, before submitting pull requests, just let me know. \r\n\r\nAlso, I don't mean to package up so many updates in a single pull request like this, but I'm not really sure how to separate out my pull requests into smaller chunks. My fork of the theme seems to just aggregate all changes continuously.\r\n\r\n@jekyll/documentation \r\n@DirtyF ","created_at":"2016-12-04T08:21:11Z","updated_at":"2016-12-23T19:49:22Z","closed_at":null,"merged_at":null,"merge_commit_sha":"7196261abd41ce7e8b04ebb387505a771bd26426","assignee":{"login":"DirtyF","id":103008,"avatar_url":"https://avatars.githubusercontent.com/u/103008?v=3","gravatar_id":"","url":"https://api.github.com/users/DirtyF","html_url":"https://github.com/DirtyF","followers_url":"https://api.github.com/users/DirtyF/followers","following_url":"https://api.github.com/users/DirtyF/following{/other_user}","gists_url":"https://api.github.com/users/DirtyF/gists{/gist_id}","starred_url":"https://api.github.com/users/DirtyF/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/DirtyF/subscriptions","organizations_url":"https://api.github.com/users/DirtyF/orgs","repos_url":"https://api.github.com/users/DirtyF/repos","events_url":"https://api.github.com/users/DirtyF/events{/privacy}","received_events_url":"https://api.github.com/users/DirtyF/received_events","type":"User","site_admin":false},"assignees":[{"login":"DirtyF","id":103008,"avatar_url":"https://avatars.githubusercontent.com/u/103008?v=3","gravatar_id":"","url":"https://api.github.com/users/DirtyF","html_url":"https://github.com/DirtyF","followers_url":"https://api.github.com/users/DirtyF/followers","following_url":"https://api.github.com/users/DirtyF/following{/other_user}","gists_url":"https://api.github.com/users/DirtyF/gists{/gist_id}","starred_url":"https://api.github.com/users/DirtyF/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/DirtyF/subscriptions","organizations_url":"https://api.github.com/users/DirtyF/orgs","repos_url":"https://api.github.com/users/DirtyF/repos","events_url":"https://api.github.com/users/DirtyF/events{/privacy}","received_events_url":"https://api.github.com/users/DirtyF/received_events","type":"User","site_admin":false},{"login":"parkr","id":237985,"avatar_url":"https://avatars.githubusercontent.com/u/237985?v=3","gravatar_id":"","url":"https://api.github.com/users/parkr","html_url":"https://github.com/parkr","followers_url":"https://api.github.com/users/parkr/followers","following_url":"https://api.github.com/users/parkr/following{/other_user}","gists_url":"https://api.github.com/users/parkr/gists{/gist_id}","starred_url":"https://api.github.com/users/parkr/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/parkr/subscriptions","organizations_url":"https://api.github.com/users/parkr/orgs","repos_url":"https://api.github.com/users/parkr/repos","events_url":"https://api.github.com/users/parkr/events{/privacy}","received_events_url":"https://api.github.com/users/parkr/received_events","type":"User","site_admin":true}],"milestone":null,"commits_url":"https://api.github.com/repos/jekyll/jekyll/pulls/5630/commits","review_comments_url":"https://api.github.com/repos/jekyll/jekyll/pulls/5630/comments","review_comment_url":"https://api.github.com/repos/jekyll/jekyll/pulls/comments{/number}","comments_url":"https://api.github.com/repos/jekyll/jekyll/issues/5630/comments","statuses_url":"https://api.github.com/repos/jekyll/jekyll/statuses/834bb82c6042d485218feb2bb68677097b27c2d6","head":{"label":"tomjohnson1492:patch-2","ref":"patch-2","sha":"834bb82c6042d485218feb2bb68677097b27c2d6","user":{"login":"tomjohnson1492","id":6385062,"avatar_url":"https://avatars.githubusercontent.com/u/6385062?v=3","gravatar_id":"","url":"https://api.github.com/users/tomjohnson1492","html_url":"https://github.com/tomjohnson1492","followers_url":"https://api.github.com/users/tomjohnson1492/followers","following_url":"https://api.github.com/users/tomjohnson1492/following{/other_user}","gists_url":"https://api.github.com/users/tomjohnson1492/gists{/gist_id}","starred_url":"https://api.github.com/users/tomjohnson1492/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tomjohnson1492/subscriptions","organizations_url":"https://api.github.com/users/tomjohnson1492/orgs","repos_url":"https://api.github.com/users/tomjohnson1492/repos","events_url":"https://api.github.com/users/tomjohnson1492/events{/privacy}","received_events_url":"https://api.github.com/users/tomjohnson1492/received_events","type":"User","site_admin":false},"repo":{"id":75111136,"name":"jekyll","full_name":"tomjohnson1492/jekyll","owner":{"login":"tomjohnson1492","id":6385062,"avatar_url":"https://avatars.githubusercontent.com/u/6385062?v=3","gravatar_id":"","url":"https://api.github.com/users/tomjohnson1492","html_url":"https://github.com/tomjohnson1492","followers_url":"https://api.github.com/users/tomjohnson1492/followers","following_url":"https://api.github.com/users/tomjohnson1492/following{/other_user}","gists_url":"https://api.github.com/users/tomjohnson1492/gists{/gist_id}","starred_url":"https://api.github.com/users/tomjohnson1492/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tomjohnson1492/subscriptions","organizations_url":"https://api.github.com/users/tomjohnson1492/orgs","repos_url":"https://api.github.com/users/tomjohnson1492/repos","events_url":"https://api.github.com/users/tomjohnson1492/events{/privacy}","received_events_url":"https://api.github.com/users/tomjohnson1492/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/tomjohnson1492/jekyll","description":":globe_with_meridians: Jekyll is a blog-aware, static site generator in Ruby","fork":true,"url":"https://api.github.com/repos/tomjohnson1492/jekyll","forks_url":"https://api.github.com/repos/tomjohnson1492/jekyll/forks","keys_url":"https://api.github.com/repos/tomjohnson1492/jekyll/keys{/key_id}","collaborators_url":"https://api.github.com/repos/tomjohnson1492/jekyll/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/tomjohnson1492/jekyll/teams","hooks_url":"https://api.github.com/repos/tomjohnson1492/jekyll/hooks","issue_events_url":"https://api.github.com/repos/tomjohnson1492/jekyll/issues/events{/number}","events_url":"https://api.github.com/repos/tomjohnson1492/jekyll/events","assignees_url":"https://api.github.com/repos/tomjohnson1492/jekyll/assignees{/user}","branches_url":"https://api.github.com/repos/tomjohnson1492/jekyll/branches{/branch}","tags_url":"https://api.github.com/repos/tomjohnson1492/jekyll/tags","blobs_url":"https://api.github.com/repos/tomjohnson1492/jekyll/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/tomjohnson1492/jekyll/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/tomjohnson1492/jekyll/git/refs{/sha}","trees_url":"https://api.github.com/repos/tomjohnson1492/jekyll/git/trees{/sha}","statuses_url":"https://api.github.com/repos/tomjohnson1492/jekyll/statuses/{sha}","languages_url":"https://api.github.com/repos/tomjohnson1492/jekyll/languages","stargazers_url":"https://api.github.com/repos/tomjohnson1492/jekyll/stargazers","contributors_url":"https://api.github.com/repos/tomjohnson1492/jekyll/contributors","subscribers_url":"https://api.github.com/repos/tomjohnson1492/jekyll/subscribers","subscription_url":"https://api.github.com/repos/tomjohnson1492/jekyll/subscription","commits_url":"https://api.github.com/repos/tomjohnson1492/jekyll/commits{/sha}","git_commits_url":"https://api.github.com/repos/tomjohnson1492/jekyll/git/commits{/sha}","comments_url":"https://api.github.com/repos/tomjohnson1492/jekyll/comments{/number}","issue_comment_url":"https://api.github.com/repos/tomjohnson1492/jekyll/issues/comments{/number}","contents_url":"https://api.github.com/repos/tomjohnson1492/jekyll/contents/{+path}","compare_url":"https://api.github.com/repos/tomjohnson1492/jekyll/compare/{base}...{head}","merges_url":"https://api.github.com/repos/tomjohnson1492/jekyll/merges","archive_url":"https://api.github.com/repos/tomjohnson1492/jekyll/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/tomjohnson1492/jekyll/downloads","issues_url":"https://api.github.com/repos/tomjohnson1492/jekyll/issues{/number}","pulls_url":"https://api.github.com/repos/tomjohnson1492/jekyll/pulls{/number}","milestones_url":"https://api.github.com/repos/tomjohnson1492/jekyll/milestones{/number}","notifications_url":"https://api.github.com/repos/tomjohnson1492/jekyll/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/tomjohnson1492/jekyll/labels{/name}","releases_url":"https://api.github.com/repos/tomjohnson1492/jekyll/releases{/id}","deployments_url":"https://api.github.com/repos/tomjohnson1492/jekyll/deployments","created_at":"2016-11-29T18:44:19Z","updated_at":"2016-11-29T18:44:24Z","pushed_at":"2016-12-14T09:11:00Z","git_url":"git://github.com/tomjohnson1492/jekyll.git","ssh_url":"git@github.com:tomjohnson1492/jekyll.git","clone_url":"https://github.com/tomjohnson1492/jekyll.git","svn_url":"https://github.com/tomjohnson1492/jekyll","homepage":"https://jekyllrb.com","size":11735,"stargazers_count":0,"watchers_count":0,"language":"Ruby","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"jekyll:master","ref":"master","sha":"25f58fe8f843a4d6d3fd59583f57edbe2d8ac51b","user":{"login":"jekyll","id":3083652,"avatar_url":"https://avatars.githubusercontent.com/u/3083652?v=3","gravatar_id":"","url":"https://api.github.com/users/jekyll","html_url":"https://github.com/jekyll","followers_url":"https://api.github.com/users/jekyll/followers","following_url":"https://api.github.com/users/jekyll/following{/other_user}","gists_url":"https://api.github.com/users/jekyll/gists{/gist_id}","starred_url":"https://api.github.com/users/jekyll/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jekyll/subscriptions","organizations_url":"https://api.github.com/users/jekyll/orgs","repos_url":"https://api.github.com/users/jekyll/repos","events_url":"https://api.github.com/users/jekyll/events{/privacy}","received_events_url":"https://api.github.com/users/jekyll/received_events","type":"Organization","site_admin":false},"repo":{"id":65252,"name":"jekyll","full_name":"jekyll/jekyll","owner":{"login":"jekyll","id":3083652,"avatar_url":"https://avatars.githubusercontent.com/u/3083652?v=3","gravatar_id":"","url":"https://api.github.com/users/jekyll","html_url":"https://github.com/jekyll","followers_url":"https://api.github.com/users/jekyll/followers","following_url":"https://api.github.com/users/jekyll/following{/other_user}","gists_url":"https://api.github.com/users/jekyll/gists{/gist_id}","starred_url":"https://api.github.com/users/jekyll/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jekyll/subscriptions","organizations_url":"https://api.github.com/users/jekyll/orgs","repos_url":"https://api.github.com/users/jekyll/repos","events_url":"https://api.github.com/users/jekyll/events{/privacy}","received_events_url":"https://api.github.com/users/jekyll/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/jekyll/jekyll","description":":globe_with_meridians: Jekyll is a blog-aware, static site generator in Ruby","fork":false,"url":"https://api.github.com/repos/jekyll/jekyll","forks_url":"https://api.github.com/repos/jekyll/jekyll/forks","keys_url":"https://api.github.com/repos/jekyll/jekyll/keys{/key_id}","collaborators_url":"https://api.github.com/repos/jekyll/jekyll/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/jekyll/jekyll/teams","hooks_url":"https://api.github.com/repos/jekyll/jekyll/hooks","issue_events_url":"https://api.github.com/repos/jekyll/jekyll/issues/events{/number}","events_url":"https://api.github.com/repos/jekyll/jekyll/events","assignees_url":"https://api.github.com/repos/jekyll/jekyll/assignees{/user}","branches_url":"https://api.github.com/repos/jekyll/jekyll/branches{/branch}","tags_url":"https://api.github.com/repos/jekyll/jekyll/tags","blobs_url":"https://api.github.com/repos/jekyll/jekyll/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/jekyll/jekyll/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/jekyll/jekyll/git/refs{/sha}","trees_url":"https://api.github.com/repos/jekyll/jekyll/git/trees{/sha}","statuses_url":"https://api.github.com/repos/jekyll/jekyll/statuses/{sha}","languages_url":"https://api.github.com/repos/jekyll/jekyll/languages","stargazers_url":"https://api.github.com/repos/jekyll/jekyll/stargazers","contributors_url":"https://api.github.com/repos/jekyll/jekyll/contributors","subscribers_url":"https://api.github.com/repos/jekyll/jekyll/subscribers","subscription_url":"https://api.github.com/repos/jekyll/jekyll/subscription","commits_url":"https://api.github.com/repos/jekyll/jekyll/commits{/sha}","git_commits_url":"https://api.github.com/repos/jekyll/jekyll/git/commits{/sha}","comments_url":"https://api.github.com/repos/jekyll/jekyll/comments{/number}","issue_comment_url":"https://api.github.com/repos/jekyll/jekyll/issues/comments{/number}","contents_url":"https://api.github.com/repos/jekyll/jekyll/contents/{+path}","compare_url":"https://api.github.com/repos/jekyll/jekyll/compare/{base}...{head}","merges_url":"https://api.github.com/repos/jekyll/jekyll/merges","archive_url":"https://api.github.com/repos/jekyll/jekyll/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/jekyll/jekyll/downloads","issues_url":"https://api.github.com/repos/jekyll/jekyll/issues{/number}","pulls_url":"https://api.github.com/repos/jekyll/jekyll/pulls{/number}","milestones_url":"https://api.github.com/repos/jekyll/jekyll/milestones{/number}","notifications_url":"https://api.github.com/repos/jekyll/jekyll/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/jekyll/jekyll/labels{/name}","releases_url":"https://api.github.com/repos/jekyll/jekyll/releases{/id}","deployments_url":"https://api.github.com/repos/jekyll/jekyll/deployments","created_at":"2008-10-20T06:29:03Z","updated_at":"2016-12-23T17:16:31Z","pushed_at":"2016-12-23T01:19:22Z","git_url":"git://github.com/jekyll/jekyll.git","ssh_url":"git@github.com:jekyll/jekyll.git","clone_url":"https://github.com/jekyll/jekyll.git","svn_url":"https://github.com/jekyll/jekyll","homepage":"https://jekyllrb.com","size":11658,"stargazers_count":27997,"watchers_count":27997,"language":"Ruby","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":6194,"mirror_url":null,"open_issues_count":135,"forks":6194,"open_issues":135,"watchers":27997,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/jekyll/jekyll/pulls/5630"},"html":{"href":"https://github.com/jekyll/jekyll/pull/5630"},"issue":{"href":"https://api.github.com/repos/jekyll/jekyll/issues/5630"},"comments":{"href":"https://api.github.com/repos/jekyll/jekyll/issues/5630/comments"},"review_comments":{"href":"https://api.github.com/repos/jekyll/jekyll/pulls/5630/comments"},"review_comment":{"href":"https://api.github.com/repos/jekyll/jekyll/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/jekyll/jekyll/pulls/5630/commits"},"statuses":{"href":"https://api.github.com/repos/jekyll/jekyll/statuses/834bb82c6042d485218feb2bb68677097b27c2d6"}}}}
{"actor":{"display_login":"pathawks"}}