{"action":"created","comment":{"url":"https://api.github.com/repos/src-d/blog/pulls/comments/148109481","pull_request_review_id":73302977,"id":148109481,"diff_hunk":"@@ -2,102 +2,33 @@\n [![Build Status](https://drone.srcd.host/api/badges/src-d/landing/status.svg)](https://drone.srcd.host/src-d/landing)\n [![Docker Repository on Quay](https://quay.io/repository/srcd/blog/status \"Docker Repository on Quay\")](https://quay.io/repository/srcd/blog)\n \n-This is our [blog](https://blog.sourced.tech) source. It uses fancy technologies, such as:\n-- [Hugo](http://gohugo.io/)\n-- [Caddy](https://caddyserver.com/)\n+This is our [blog](https://blog.sourced.tech) source.\n \n-## Available shortcodes\n+# Requirements\n \n-### Code scroll\n+You need to have [Yarn installed](https://yarnpkg.com/en/docs/install) to build the js and css assets. It also lets you locally serve the blog to test and validate it while you are developing.\n \n-If your code is too long you can make it have a fixed height and be scrollable.\n-\n-```\n-{{% codescroll height=\"500\" %}}\n-\\`\\`\\`js\n-my fancy code\n-\\`\\`\\`\n-{{% /codescroll %}}\n-```\n-\n-### Center\n-\n-Center the text\n-\n-```\n-{{% center %}}\n-some text\n-{{% /center %}}\n-```\n-\n-### Caption\n-\n-Renders an image with caption\n-\n-```\n-{{% caption src=\"url to image\" title=\"title of image\" %}}\n-caption of the image, html and md allowed\n-{{% /caption %}}\n+You can ensure if it is available in your machine running:\n+```shell\n+yarn --version; # prints your Yarn version\n ```\n \n-### YouTube video\n+The blog also uses:\n+- [Hugo](http://gohugo.io): to build the static html from the markdown content files; it is automatically downloaded and installed at building time.\n+- [Caddy](https://caddyserver.com): to serve the static files in production; it is provided by the caddy docker image\n \n-Display a YouTube video\n+# Build\n \n-```\n-{{% youtube VIDEO_ID %}}\n-```\n-\n-### Gist\n-\n-Display a Gist (even an IPython Notebook)\n+You need to satisfy the [project requirements](#requirements), and then to run:\n \n-```\n-{{% gist username gist_id %}}\n+```shell\n+make build;\n ```\n \n-### Grid of 2 elements\n+# Contributing\n \n-```\n-{{% grid %}}\n-{{% grid-cell %}}\n-SOMETHING LEFT\n-{{% /grid-cell %}}\n-\n-{{% grid-cell %}}\n-SOMETHING RIGHT\n-{{% /grid-cell %}}\n-{{% /grid %}}\n-```\n-\n-### Tweet\n-\n-Renders a tweet\n-\n-```\n-{{% tweet TWEET_ID %}}\n-```\n-\n-### Anchor\n-\n-Anchor you can link to with `[foo](#anchor)`:\n-\n-```\n-{{% anchor \"anchor\" %}}\n-```\n-\n-### codepen\n-\n-An embedded codepen. Whenever possible, use the sourced account.\n-\n-```\n-{{% codepen slug=\"aaaaaa\" title=\"My post example\" %}}\n-```\n+If you want to contribute to this project, you will find more info in the [CONTRIBUTING.md](CONTRIBUTING.md)\n \n-Available options are:\n+# License\n \n-- `height` (_optional_, defaults to 573) height of the codepen.\n-- `slug` (_required_) the slug of the pen. Usually the last part of its URL\n-  (for a sourced pen, the url looks like codepen.io/sourced/pen/slug).\n-- `user` (_optional_, defaults to sourced) the user in codepen.\n-- `title`(_optional_, defaults to sourced) a title for the codepen.\n+Copyright (c) 2015 Máximo Cuadros, see [LICENSE](LICENSE)","path":"README.md","position":119,"original_position":119,"commit_id":"eea4f5dc280c577332dc6ddf3f9a7c9c22752bd6","original_commit_id":"eea4f5dc280c577332dc6ddf3f9a7c9c22752bd6","user":{"login":"dpordomingo","id":2437584,"avatar_url":"https://avatars2.githubusercontent.com/u/2437584?v=4","gravatar_id":"","url":"https://api.github.com/users/dpordomingo","html_url":"https://github.com/dpordomingo","followers_url":"https://api.github.com/users/dpordomingo/followers","following_url":"https://api.github.com/users/dpordomingo/following{/other_user}","gists_url":"https://api.github.com/users/dpordomingo/gists{/gist_id}","starred_url":"https://api.github.com/users/dpordomingo/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dpordomingo/subscriptions","organizations_url":"https://api.github.com/users/dpordomingo/orgs","repos_url":"https://api.github.com/users/dpordomingo/repos","events_url":"https://api.github.com/users/dpordomingo/events{/privacy}","received_events_url":"https://api.github.com/users/dpordomingo/received_events","type":"User","site_admin":false},"body":"Since it was defined by @mcuadros  in that way from the very beginning, I didn't want to relicense it in a documentation issue.\r\n\r\nI opened an issue https://github.com/src-d/blog/issues/151 to address this new feature request.","created_at":"2017-10-31T19:53:48Z","updated_at":"2017-10-31T19:53:48Z","html_url":"https://github.com/src-d/blog/pull/148#discussion_r148109481","pull_request_url":"https://api.github.com/repos/src-d/blog/pulls/148","author_association":"MEMBER","_links":{"self":{"href":"https://api.github.com/repos/src-d/blog/pulls/comments/148109481"},"html":{"href":"https://github.com/src-d/blog/pull/148#discussion_r148109481"},"pull_request":{"href":"https://api.github.com/repos/src-d/blog/pulls/148"}},"in_reply_to_id":147990693},"pull_request":{"url":"https://api.github.com/repos/src-d/blog/pulls/148","id":149774946,"html_url":"https://github.com/src-d/blog/pull/148","diff_url":"https://github.com/src-d/blog/pull/148.diff","patch_url":"https://github.com/src-d/blog/pull/148.patch","issue_url":"https://api.github.com/repos/src-d/blog/issues/148","number":148,"state":"open","locked":false,"title":"Documentation","user":{"login":"dpordomingo","id":2437584,"avatar_url":"https://avatars2.githubusercontent.com/u/2437584?v=4","gravatar_id":"","url":"https://api.github.com/users/dpordomingo","html_url":"https://github.com/dpordomingo","followers_url":"https://api.github.com/users/dpordomingo/followers","following_url":"https://api.github.com/users/dpordomingo/following{/other_user}","gists_url":"https://api.github.com/users/dpordomingo/gists{/gist_id}","starred_url":"https://api.github.com/users/dpordomingo/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dpordomingo/subscriptions","organizations_url":"https://api.github.com/users/dpordomingo/orgs","repos_url":"https://api.github.com/users/dpordomingo/repos","events_url":"https://api.github.com/users/dpordomingo/events{/privacy}","received_events_url":"https://api.github.com/users/dpordomingo/received_events","type":"User","site_admin":false},"body":"closes: https://github.com/src-d/blog/issues/90 , https://github.com/src-d/blog/issues/102 , https://github.com/src-d/blog/issues/124 , https://github.com/src-d/blog/issues/143 , https://github.com/src-d/backlog/issues/1058\r\n\r\nThe commit that really documments the blog is the last one: eea4f5d\r\n- The [README.md](https://github.com/dpordomingo/blog/blob/eea4f5dc280c577332dc6ddf3f9a7c9c22752bd6/README.md) has been polished\r\n- The contribution guides can be viewed at the [CONTRIBUTING.md](https://github.com/dpordomingo/blog/blob/eea4f5dc280c577332dc6ddf3f9a7c9c22752bd6/CONTRIBUTING.md)\r\n- The shortcode documentation can be biewed at [shortcodes blog documentation post](https://blog-staging.srcd.run/documentation/shortcodes/)\r\n\r\nThe previous commits prepares the blog repository to be \"documentable\" ;)\r\nMost important changes that has been done (and documented), are:\r\n- `make serve` will locally serve the blog a29dfe6 -> *wiiiiiiiii* \r\n- authors are now stored under `data/authors.yml` file https://github.com/src-d/blog/commit/69152a23ed4a7ebed59c373f29320995da13394b\r\n- all posts must be stored under `contents/post` (no longer `archive` nor `upcoming`) 23539b7\r\n- post that should not yet being published, must be marked as `draft: true` 23539b7\r\n","created_at":"2017-10-31T12:44:06Z","updated_at":"2017-10-31T19:53:48Z","closed_at":null,"merged_at":null,"merge_commit_sha":"2d538c82cbdcac425aee4cb6eeb6fb58d96f4ef6","assignee":null,"assignees":[],"requested_reviewers":[],"milestone":null,"commits_url":"https://api.github.com/repos/src-d/blog/pulls/148/commits","review_comments_url":"https://api.github.com/repos/src-d/blog/pulls/148/comments","review_comment_url":"https://api.github.com/repos/src-d/blog/pulls/comments{/number}","comments_url":"https://api.github.com/repos/src-d/blog/issues/148/comments","statuses_url":"https://api.github.com/repos/src-d/blog/statuses/eea4f5dc280c577332dc6ddf3f9a7c9c22752bd6","head":{"label":"dpordomingo:documentation","ref":"documentation","sha":"eea4f5dc280c577332dc6ddf3f9a7c9c22752bd6","user":{"login":"dpordomingo","id":2437584,"avatar_url":"https://avatars2.githubusercontent.com/u/2437584?v=4","gravatar_id":"","url":"https://api.github.com/users/dpordomingo","html_url":"https://github.com/dpordomingo","followers_url":"https://api.github.com/users/dpordomingo/followers","following_url":"https://api.github.com/users/dpordomingo/following{/other_user}","gists_url":"https://api.github.com/users/dpordomingo/gists{/gist_id}","starred_url":"https://api.github.com/users/dpordomingo/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dpordomingo/subscriptions","organizations_url":"https://api.github.com/users/dpordomingo/orgs","repos_url":"https://api.github.com/users/dpordomingo/repos","events_url":"https://api.github.com/users/dpordomingo/events{/privacy}","received_events_url":"https://api.github.com/users/dpordomingo/received_events","type":"User","site_admin":false},"repo":{"id":74950145,"name":"blog","full_name":"dpordomingo/blog","owner":{"login":"dpordomingo","id":2437584,"avatar_url":"https://avatars2.githubusercontent.com/u/2437584?v=4","gravatar_id":"","url":"https://api.github.com/users/dpordomingo","html_url":"https://github.com/dpordomingo","followers_url":"https://api.github.com/users/dpordomingo/followers","following_url":"https://api.github.com/users/dpordomingo/following{/other_user}","gists_url":"https://api.github.com/users/dpordomingo/gists{/gist_id}","starred_url":"https://api.github.com/users/dpordomingo/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dpordomingo/subscriptions","organizations_url":"https://api.github.com/users/dpordomingo/orgs","repos_url":"https://api.github.com/users/dpordomingo/repos","events_url":"https://api.github.com/users/dpordomingo/events{/privacy}","received_events_url":"https://api.github.com/users/dpordomingo/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/dpordomingo/blog","description":"source{d} blog created with auto-hugo:","fork":true,"url":"https://api.github.com/repos/dpordomingo/blog","forks_url":"https://api.github.com/repos/dpordomingo/blog/forks","keys_url":"https://api.github.com/repos/dpordomingo/blog/keys{/key_id}","collaborators_url":"https://api.github.com/repos/dpordomingo/blog/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/dpordomingo/blog/teams","hooks_url":"https://api.github.com/repos/dpordomingo/blog/hooks","issue_events_url":"https://api.github.com/repos/dpordomingo/blog/issues/events{/number}","events_url":"https://api.github.com/repos/dpordomingo/blog/events","assignees_url":"https://api.github.com/repos/dpordomingo/blog/assignees{/user}","branches_url":"https://api.github.com/repos/dpordomingo/blog/branches{/branch}","tags_url":"https://api.github.com/repos/dpordomingo/blog/tags","blobs_url":"https://api.github.com/repos/dpordomingo/blog/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/dpordomingo/blog/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/dpordomingo/blog/git/refs{/sha}","trees_url":"https://api.github.com/repos/dpordomingo/blog/git/trees{/sha}","statuses_url":"https://api.github.com/repos/dpordomingo/blog/statuses/{sha}","languages_url":"https://api.github.com/repos/dpordomingo/blog/languages","stargazers_url":"https://api.github.com/repos/dpordomingo/blog/stargazers","contributors_url":"https://api.github.com/repos/dpordomingo/blog/contributors","subscribers_url":"https://api.github.com/repos/dpordomingo/blog/subscribers","subscription_url":"https://api.github.com/repos/dpordomingo/blog/subscription","commits_url":"https://api.github.com/repos/dpordomingo/blog/commits{/sha}","git_commits_url":"https://api.github.com/repos/dpordomingo/blog/git/commits{/sha}","comments_url":"https://api.github.com/repos/dpordomingo/blog/comments{/number}","issue_comment_url":"https://api.github.com/repos/dpordomingo/blog/issues/comments{/number}","contents_url":"https://api.github.com/repos/dpordomingo/blog/contents/{+path}","compare_url":"https://api.github.com/repos/dpordomingo/blog/compare/{base}...{head}","merges_url":"https://api.github.com/repos/dpordomingo/blog/merges","archive_url":"https://api.github.com/repos/dpordomingo/blog/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/dpordomingo/blog/downloads","issues_url":"https://api.github.com/repos/dpordomingo/blog/issues{/number}","pulls_url":"https://api.github.com/repos/dpordomingo/blog/pulls{/number}","milestones_url":"https://api.github.com/repos/dpordomingo/blog/milestones{/number}","notifications_url":"https://api.github.com/repos/dpordomingo/blog/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/dpordomingo/blog/labels{/name}","releases_url":"https://api.github.com/repos/dpordomingo/blog/releases{/id}","deployments_url":"https://api.github.com/repos/dpordomingo/blog/deployments","created_at":"2016-11-28T07:55:14Z","updated_at":"2016-11-28T07:55:16Z","pushed_at":"2017-10-31T19:31:17Z","git_url":"git://github.com/dpordomingo/blog.git","ssh_url":"git@github.com:dpordomingo/blog.git","clone_url":"https://github.com/dpordomingo/blog.git","svn_url":"https://github.com/dpordomingo/blog","homepage":"http://mcuadros.github.io/autohugo","size":48917,"stargazers_count":0,"watchers_count":0,"language":"HTML","has_issues":false,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"archived":false,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"src-d:master","ref":"master","sha":"4a7b7172fa5ea7f829e18edacb31561f2fac58d4","user":{"login":"src-d","id":15128793,"avatar_url":"https://avatars2.githubusercontent.com/u/15128793?v=4","gravatar_id":"","url":"https://api.github.com/users/src-d","html_url":"https://github.com/src-d","followers_url":"https://api.github.com/users/src-d/followers","following_url":"https://api.github.com/users/src-d/following{/other_user}","gists_url":"https://api.github.com/users/src-d/gists{/gist_id}","starred_url":"https://api.github.com/users/src-d/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/src-d/subscriptions","organizations_url":"https://api.github.com/users/src-d/orgs","repos_url":"https://api.github.com/users/src-d/repos","events_url":"https://api.github.com/users/src-d/events{/privacy}","received_events_url":"https://api.github.com/users/src-d/received_events","type":"Organization","site_admin":false},"repo":{"id":44317537,"name":"blog","full_name":"src-d/blog","owner":{"login":"src-d","id":15128793,"avatar_url":"https://avatars2.githubusercontent.com/u/15128793?v=4","gravatar_id":"","url":"https://api.github.com/users/src-d","html_url":"https://github.com/src-d","followers_url":"https://api.github.com/users/src-d/followers","following_url":"https://api.github.com/users/src-d/following{/other_user}","gists_url":"https://api.github.com/users/src-d/gists{/gist_id}","starred_url":"https://api.github.com/users/src-d/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/src-d/subscriptions","organizations_url":"https://api.github.com/users/src-d/orgs","repos_url":"https://api.github.com/users/src-d/repos","events_url":"https://api.github.com/users/src-d/events{/privacy}","received_events_url":"https://api.github.com/users/src-d/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/src-d/blog","description":"source{d} blog","fork":false,"url":"https://api.github.com/repos/src-d/blog","forks_url":"https://api.github.com/repos/src-d/blog/forks","keys_url":"https://api.github.com/repos/src-d/blog/keys{/key_id}","collaborators_url":"https://api.github.com/repos/src-d/blog/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/src-d/blog/teams","hooks_url":"https://api.github.com/repos/src-d/blog/hooks","issue_events_url":"https://api.github.com/repos/src-d/blog/issues/events{/number}","events_url":"https://api.github.com/repos/src-d/blog/events","assignees_url":"https://api.github.com/repos/src-d/blog/assignees{/user}","branches_url":"https://api.github.com/repos/src-d/blog/branches{/branch}","tags_url":"https://api.github.com/repos/src-d/blog/tags","blobs_url":"https://api.github.com/repos/src-d/blog/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/src-d/blog/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/src-d/blog/git/refs{/sha}","trees_url":"https://api.github.com/repos/src-d/blog/git/trees{/sha}","statuses_url":"https://api.github.com/repos/src-d/blog/statuses/{sha}","languages_url":"https://api.github.com/repos/src-d/blog/languages","stargazers_url":"https://api.github.com/repos/src-d/blog/stargazers","contributors_url":"https://api.github.com/repos/src-d/blog/contributors","subscribers_url":"https://api.github.com/repos/src-d/blog/subscribers","subscription_url":"https://api.github.com/repos/src-d/blog/subscription","commits_url":"https://api.github.com/repos/src-d/blog/commits{/sha}","git_commits_url":"https://api.github.com/repos/src-d/blog/git/commits{/sha}","comments_url":"https://api.github.com/repos/src-d/blog/comments{/number}","issue_comment_url":"https://api.github.com/repos/src-d/blog/issues/comments{/number}","contents_url":"https://api.github.com/repos/src-d/blog/contents/{+path}","compare_url":"https://api.github.com/repos/src-d/blog/compare/{base}...{head}","merges_url":"https://api.github.com/repos/src-d/blog/merges","archive_url":"https://api.github.com/repos/src-d/blog/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/src-d/blog/downloads","issues_url":"https://api.github.com/repos/src-d/blog/issues{/number}","pulls_url":"https://api.github.com/repos/src-d/blog/pulls{/number}","milestones_url":"https://api.github.com/repos/src-d/blog/milestones{/number}","notifications_url":"https://api.github.com/repos/src-d/blog/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/src-d/blog/labels{/name}","releases_url":"https://api.github.com/repos/src-d/blog/releases{/id}","deployments_url":"https://api.github.com/repos/src-d/blog/deployments","created_at":"2015-10-15T12:58:09Z","updated_at":"2017-07-14T11:08:39Z","pushed_at":"2017-10-31T19:26:42Z","git_url":"git://github.com/src-d/blog.git","ssh_url":"git@github.com:src-d/blog.git","clone_url":"https://github.com/src-d/blog.git","svn_url":"https://github.com/src-d/blog","homepage":"https://blog.sourced.tech/","size":48838,"stargazers_count":17,"watchers_count":17,"language":"HTML","has_issues":true,"has_projects":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":23,"mirror_url":null,"archived":false,"open_issues_count":10,"forks":23,"open_issues":10,"watchers":17,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/src-d/blog/pulls/148"},"html":{"href":"https://github.com/src-d/blog/pull/148"},"issue":{"href":"https://api.github.com/repos/src-d/blog/issues/148"},"comments":{"href":"https://api.github.com/repos/src-d/blog/issues/148/comments"},"review_comments":{"href":"https://api.github.com/repos/src-d/blog/pulls/148/comments"},"review_comment":{"href":"https://api.github.com/repos/src-d/blog/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/src-d/blog/pulls/148/commits"},"statuses":{"href":"https://api.github.com/repos/src-d/blog/statuses/eea4f5dc280c577332dc6ddf3f9a7c9c22752bd6"}},"author_association":"MEMBER"}}
{"actor":{"display_login":"dpordomingo"}}