{"action":"created","comment":{"url":"https://api.github.com/repos/bitcoin/bitcoin.org/pulls/comments/28253734","id":28253734,"diff_hunk":"@@ -134,73 +134,114 @@ You simply need to push additional commits on the appropriate branch of your Git\n \n Simple text changes can be previewed live on bitcoin.org. You only need to click anywhere on the page and hold your mouse button for one second. You'll then be able to edit the page just like a document. Changes will be lost as soon as the page is refreshed.\n \n-#### Build Site With Jekyll From Bundler\n+#### Build The Site Locally\n \n-Make sure you have ruby 2.0. If you don't, we recommend\n-[installing it with RVM](https://www.digitalocean.com/community/articles/how-to-install-ruby-on-rails-on-ubuntu-14-04-using-rvm),\n-which can usually be done by running the following three commands:\n+For anything more than simple text previews, you will need to build the\n+site. If you can't do this yourself using the instructions below, please\n+[open a pull request][pull request] with your suggested change and one\n+of the site developers will create a preview for you.\n+\n+To build the site, you need to go through a one-time installation\n+procedure that takes 15 to 30 minutes.  After that you can build the\n+site an unlimited number of times with no extra work.\n+\n+##### Install The Dependencies\n+\n+Before building the site, you need to install the following\n+dependencies and tools, which are pretty easy on any modern Linux:\n+\n+**Install binary libraries and tools**\n+\n+On recent versions of Ubuntu and Debian, you can run the following\n+command to ensure you have the required libraries, headers, and tools:\n+\n+    sudo apt-get install build-essential git libicu-dev zlib1g-dev\n+\n+**Install RVM**\n+\n+Install RVM using either the [easy instructions](https://rvm.io/) or the\n+[more secure instructions](https://rvm.io/rvm/security).\n+\n+Read the instructions printed to your console during setup to enable the\n+`rvm` command in your shell.  After installation, you need to run the\n+following command:\n \n-    \\curl -sSL https://get.rvm.io | bash -s stable\n     source ~/.rvm/scripts/rvm\n+\n+**Install Ruby 2.0.0**\n+\n+To install Ruby 2.0.0, simply run this command:\n+\n     rvm install ruby-2.0.0\n \n-Next, you need to install bundler, and let it install all gems you need\n-to build the site. You must run the last command from within your local\n-bitcoin.org repository:\n+Sometimes this will find a pre-compiled Ruby package for your Linux\n+distribution, but sometimes it will need to compile Ruby from scratch\n+(which takes about 15 minutes).\n \n-    gem install bundler\n-    bundle install\n+After Ruby 2.0.0 is installed, make it your default Ruby:\n+\n+    rvm alias create default ruby-2.0.0\n \n-Finally, you can build the website in _site/:\n+And tell your system to use it:\n \n-    bundle exec jekyll build\n+    rvm use default\n \n-You can then copy the output files from _site/ to the root of your web server.\n-If you have no web server, run `bundle exec jekyll serve` and visit\n-http://127.0.0.1:4000/. This server requires you to add a trailing \".html\"\n-by hand in your browser address bar.\n+(Note: you can use a different default Ruby, but you if you ever change","path":"README.md","position":72,"original_position":72,"commit_id":"3eee4811fd2f0c407972d5f8112feb46dfcfe44a","original_commit_id":"3eee4811fd2f0c407972d5f8112feb46dfcfe44a","user":{"login":"saivann","id":3578089,"avatar_url":"https://avatars.githubusercontent.com/u/3578089?v=3","gravatar_id":"","url":"https://api.github.com/users/saivann","html_url":"https://github.com/saivann","followers_url":"https://api.github.com/users/saivann/followers","following_url":"https://api.github.com/users/saivann/following{/other_user}","gists_url":"https://api.github.com/users/saivann/gists{/gist_id}","starred_url":"https://api.github.com/users/saivann/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/saivann/subscriptions","organizations_url":"https://api.github.com/users/saivann/orgs","repos_url":"https://api.github.com/users/saivann/repos","events_url":"https://api.github.com/users/saivann/events{/privacy}","received_events_url":"https://api.github.com/users/saivann/received_events","type":"User","site_admin":false},"body":"s/but you if you ever/but if you ever/","created_at":"2015-04-13T16:28:29Z","updated_at":"2015-04-13T16:28:29Z","html_url":"https://github.com/bitcoin/bitcoin.org/pull/823#discussion_r28253734","pull_request_url":"https://api.github.com/repos/bitcoin/bitcoin.org/pulls/823","_links":{"self":{"href":"https://api.github.com/repos/bitcoin/bitcoin.org/pulls/comments/28253734"},"html":{"href":"https://github.com/bitcoin/bitcoin.org/pull/823#discussion_r28253734"},"pull_request":{"href":"https://api.github.com/repos/bitcoin/bitcoin.org/pulls/823"}}},"pull_request":{"url":"https://api.github.com/repos/bitcoin/bitcoin.org/pulls/823","id":33125260,"html_url":"https://github.com/bitcoin/bitcoin.org/pull/823","diff_url":"https://github.com/bitcoin/bitcoin.org/pull/823.diff","patch_url":"https://github.com/bitcoin/bitcoin.org/pull/823.patch","issue_url":"https://api.github.com/repos/bitcoin/bitcoin.org/issues/823","number":823,"state":"open","locked":false,"title":"Various Backend & Site Docs Updates","user":{"login":"harding","id":61096,"avatar_url":"https://avatars.githubusercontent.com/u/61096?v=3","gravatar_id":"","url":"https://api.github.com/users/harding","html_url":"https://github.com/harding","followers_url":"https://api.github.com/users/harding/followers","following_url":"https://api.github.com/users/harding/following{/other_user}","gists_url":"https://api.github.com/users/harding/gists{/gist_id}","starred_url":"https://api.github.com/users/harding/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/harding/subscriptions","organizations_url":"https://api.github.com/users/harding/orgs","repos_url":"https://api.github.com/users/harding/repos","events_url":"https://api.github.com/users/harding/events{/privacy}","received_events_url":"https://api.github.com/users/harding/received_events","type":"User","site_admin":false},"body":"Separated into multiple commits for easy review, this pull includes:\r\n\r\n1. Require Jekyll 1.3.0 through Bundle. No more alternative versions allowed if using the Makefile. Require Ruby 2.0.0. Remove a plugin that's no longer necessary in Jekyll >=1.0.0. Remove plugin workarounds that are no longer required on Jekyll 1.3.0.  Verified that layout is correct after workaround removal.\r\n\r\n2. Add Makefile targets for `make deployment` (for build server) and `make travis` (for Travis CI).  Deployment uses only libs from Bundle (i.e. `bundle --deployment` and also updates libs automatically when possible); otherwise it's identical to `make valid`.  Travis is `make all` with an extra keep alive previously part of `make all`.\r\n\r\n3. Add a new plugin for `jekyll serve` to make `/foo` serve the file at `/foo.html` (reducing the amount of instructions we need). Add Makefile target for `make preview` to launch `bundle exec jekyll serve`. Major update of site docs to describe installing; I spent several hours repeatedly starting from a bare install of Ubuntu Server and then testing these instructions until a successful build/preview of the site, so hopefully they're bulletproof.\r\n\r\nBefore merging this commit, I will install RVM and Ruby 2.0.0 on the site build server and translation build server. (I'll also monitor the site build server and actual site uploads for problems immediately after commit.  In order to ensure I have time to fix any problems, I'll only consider merging before noon my localtime.)\r\n\r\nAfter this is merged and the site successfully updated, I'll re-merge the developer glossary and also rebase the Bitcoin Core 0.10.1 branch (which should be fine, but why take chances?)\r\n","created_at":"2015-04-12T19:47:47Z","updated_at":"2015-04-13T16:28:29Z","closed_at":null,"merged_at":null,"merge_commit_sha":"8bbcd753d4ee860b2263a56895de318bc85f241e","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/bitcoin/bitcoin.org/pulls/823/commits","review_comments_url":"https://api.github.com/repos/bitcoin/bitcoin.org/pulls/823/comments","review_comment_url":"https://api.github.com/repos/bitcoin/bitcoin.org/pulls/comments{/number}","comments_url":"https://api.github.com/repos/bitcoin/bitcoin.org/issues/823/comments","statuses_url":"https://api.github.com/repos/bitcoin/bitcoin.org/statuses/3eee4811fd2f0c407972d5f8112feb46dfcfe44a","head":{"label":"harding:build-updates","ref":"build-updates","sha":"3eee4811fd2f0c407972d5f8112feb46dfcfe44a","user":{"login":"harding","id":61096,"avatar_url":"https://avatars.githubusercontent.com/u/61096?v=3","gravatar_id":"","url":"https://api.github.com/users/harding","html_url":"https://github.com/harding","followers_url":"https://api.github.com/users/harding/followers","following_url":"https://api.github.com/users/harding/following{/other_user}","gists_url":"https://api.github.com/users/harding/gists{/gist_id}","starred_url":"https://api.github.com/users/harding/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/harding/subscriptions","organizations_url":"https://api.github.com/users/harding/orgs","repos_url":"https://api.github.com/users/harding/repos","events_url":"https://api.github.com/users/harding/events{/privacy}","received_events_url":"https://api.github.com/users/harding/received_events","type":"User","site_admin":false},"repo":{"id":19798699,"name":"bitcoin.org","full_name":"harding/bitcoin.org","owner":{"login":"harding","id":61096,"avatar_url":"https://avatars.githubusercontent.com/u/61096?v=3","gravatar_id":"","url":"https://api.github.com/users/harding","html_url":"https://github.com/harding","followers_url":"https://api.github.com/users/harding/followers","following_url":"https://api.github.com/users/harding/following{/other_user}","gists_url":"https://api.github.com/users/harding/gists{/gist_id}","starred_url":"https://api.github.com/users/harding/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/harding/subscriptions","organizations_url":"https://api.github.com/users/harding/orgs","repos_url":"https://api.github.com/users/harding/repos","events_url":"https://api.github.com/users/harding/events{/privacy}","received_events_url":"https://api.github.com/users/harding/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/harding/bitcoin.org","description":"Bitcoin.org website","fork":true,"url":"https://api.github.com/repos/harding/bitcoin.org","forks_url":"https://api.github.com/repos/harding/bitcoin.org/forks","keys_url":"https://api.github.com/repos/harding/bitcoin.org/keys{/key_id}","collaborators_url":"https://api.github.com/repos/harding/bitcoin.org/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/harding/bitcoin.org/teams","hooks_url":"https://api.github.com/repos/harding/bitcoin.org/hooks","issue_events_url":"https://api.github.com/repos/harding/bitcoin.org/issues/events{/number}","events_url":"https://api.github.com/repos/harding/bitcoin.org/events","assignees_url":"https://api.github.com/repos/harding/bitcoin.org/assignees{/user}","branches_url":"https://api.github.com/repos/harding/bitcoin.org/branches{/branch}","tags_url":"https://api.github.com/repos/harding/bitcoin.org/tags","blobs_url":"https://api.github.com/repos/harding/bitcoin.org/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/harding/bitcoin.org/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/harding/bitcoin.org/git/refs{/sha}","trees_url":"https://api.github.com/repos/harding/bitcoin.org/git/trees{/sha}","statuses_url":"https://api.github.com/repos/harding/bitcoin.org/statuses/{sha}","languages_url":"https://api.github.com/repos/harding/bitcoin.org/languages","stargazers_url":"https://api.github.com/repos/harding/bitcoin.org/stargazers","contributors_url":"https://api.github.com/repos/harding/bitcoin.org/contributors","subscribers_url":"https://api.github.com/repos/harding/bitcoin.org/subscribers","subscription_url":"https://api.github.com/repos/harding/bitcoin.org/subscription","commits_url":"https://api.github.com/repos/harding/bitcoin.org/commits{/sha}","git_commits_url":"https://api.github.com/repos/harding/bitcoin.org/git/commits{/sha}","comments_url":"https://api.github.com/repos/harding/bitcoin.org/comments{/number}","issue_comment_url":"https://api.github.com/repos/harding/bitcoin.org/issues/comments{/number}","contents_url":"https://api.github.com/repos/harding/bitcoin.org/contents/{+path}","compare_url":"https://api.github.com/repos/harding/bitcoin.org/compare/{base}...{head}","merges_url":"https://api.github.com/repos/harding/bitcoin.org/merges","archive_url":"https://api.github.com/repos/harding/bitcoin.org/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/harding/bitcoin.org/downloads","issues_url":"https://api.github.com/repos/harding/bitcoin.org/issues{/number}","pulls_url":"https://api.github.com/repos/harding/bitcoin.org/pulls{/number}","milestones_url":"https://api.github.com/repos/harding/bitcoin.org/milestones{/number}","notifications_url":"https://api.github.com/repos/harding/bitcoin.org/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/harding/bitcoin.org/labels{/name}","releases_url":"https://api.github.com/repos/harding/bitcoin.org/releases{/id}","created_at":"2014-05-14T22:43:19Z","updated_at":"2015-04-11T13:45:14Z","pushed_at":"2015-04-13T00:51:19Z","git_url":"git://github.com/harding/bitcoin.org.git","ssh_url":"git@github.com:harding/bitcoin.org.git","clone_url":"https://github.com/harding/bitcoin.org.git","svn_url":"https://github.com/harding/bitcoin.org","homepage":"http://www.bitcoin.org/","size":18983,"stargazers_count":0,"watchers_count":0,"language":"HTML","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":"bitcoin:master","ref":"master","sha":"a6d5b863bf23033d254d323c6f4689242cd43847","user":{"login":"bitcoin","id":528860,"avatar_url":"https://avatars.githubusercontent.com/u/528860?v=3","gravatar_id":"","url":"https://api.github.com/users/bitcoin","html_url":"https://github.com/bitcoin","followers_url":"https://api.github.com/users/bitcoin/followers","following_url":"https://api.github.com/users/bitcoin/following{/other_user}","gists_url":"https://api.github.com/users/bitcoin/gists{/gist_id}","starred_url":"https://api.github.com/users/bitcoin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bitcoin/subscriptions","organizations_url":"https://api.github.com/users/bitcoin/orgs","repos_url":"https://api.github.com/users/bitcoin/repos","events_url":"https://api.github.com/users/bitcoin/events{/privacy}","received_events_url":"https://api.github.com/users/bitcoin/received_events","type":"Organization","site_admin":false},"repo":{"id":2304420,"name":"bitcoin.org","full_name":"bitcoin/bitcoin.org","owner":{"login":"bitcoin","id":528860,"avatar_url":"https://avatars.githubusercontent.com/u/528860?v=3","gravatar_id":"","url":"https://api.github.com/users/bitcoin","html_url":"https://github.com/bitcoin","followers_url":"https://api.github.com/users/bitcoin/followers","following_url":"https://api.github.com/users/bitcoin/following{/other_user}","gists_url":"https://api.github.com/users/bitcoin/gists{/gist_id}","starred_url":"https://api.github.com/users/bitcoin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bitcoin/subscriptions","organizations_url":"https://api.github.com/users/bitcoin/orgs","repos_url":"https://api.github.com/users/bitcoin/repos","events_url":"https://api.github.com/users/bitcoin/events{/privacy}","received_events_url":"https://api.github.com/users/bitcoin/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/bitcoin/bitcoin.org","description":"Bitcoin.org website","fork":false,"url":"https://api.github.com/repos/bitcoin/bitcoin.org","forks_url":"https://api.github.com/repos/bitcoin/bitcoin.org/forks","keys_url":"https://api.github.com/repos/bitcoin/bitcoin.org/keys{/key_id}","collaborators_url":"https://api.github.com/repos/bitcoin/bitcoin.org/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/bitcoin/bitcoin.org/teams","hooks_url":"https://api.github.com/repos/bitcoin/bitcoin.org/hooks","issue_events_url":"https://api.github.com/repos/bitcoin/bitcoin.org/issues/events{/number}","events_url":"https://api.github.com/repos/bitcoin/bitcoin.org/events","assignees_url":"https://api.github.com/repos/bitcoin/bitcoin.org/assignees{/user}","branches_url":"https://api.github.com/repos/bitcoin/bitcoin.org/branches{/branch}","tags_url":"https://api.github.com/repos/bitcoin/bitcoin.org/tags","blobs_url":"https://api.github.com/repos/bitcoin/bitcoin.org/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/bitcoin/bitcoin.org/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/bitcoin/bitcoin.org/git/refs{/sha}","trees_url":"https://api.github.com/repos/bitcoin/bitcoin.org/git/trees{/sha}","statuses_url":"https://api.github.com/repos/bitcoin/bitcoin.org/statuses/{sha}","languages_url":"https://api.github.com/repos/bitcoin/bitcoin.org/languages","stargazers_url":"https://api.github.com/repos/bitcoin/bitcoin.org/stargazers","contributors_url":"https://api.github.com/repos/bitcoin/bitcoin.org/contributors","subscribers_url":"https://api.github.com/repos/bitcoin/bitcoin.org/subscribers","subscription_url":"https://api.github.com/repos/bitcoin/bitcoin.org/subscription","commits_url":"https://api.github.com/repos/bitcoin/bitcoin.org/commits{/sha}","git_commits_url":"https://api.github.com/repos/bitcoin/bitcoin.org/git/commits{/sha}","comments_url":"https://api.github.com/repos/bitcoin/bitcoin.org/comments{/number}","issue_comment_url":"https://api.github.com/repos/bitcoin/bitcoin.org/issues/comments{/number}","contents_url":"https://api.github.com/repos/bitcoin/bitcoin.org/contents/{+path}","compare_url":"https://api.github.com/repos/bitcoin/bitcoin.org/compare/{base}...{head}","merges_url":"https://api.github.com/repos/bitcoin/bitcoin.org/merges","archive_url":"https://api.github.com/repos/bitcoin/bitcoin.org/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/bitcoin/bitcoin.org/downloads","issues_url":"https://api.github.com/repos/bitcoin/bitcoin.org/issues{/number}","pulls_url":"https://api.github.com/repos/bitcoin/bitcoin.org/pulls{/number}","milestones_url":"https://api.github.com/repos/bitcoin/bitcoin.org/milestones{/number}","notifications_url":"https://api.github.com/repos/bitcoin/bitcoin.org/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/bitcoin/bitcoin.org/labels{/name}","releases_url":"https://api.github.com/repos/bitcoin/bitcoin.org/releases{/id}","created_at":"2011-08-31T21:58:01Z","updated_at":"2015-04-13T12:20:00Z","pushed_at":"2015-04-13T12:19:59Z","git_url":"git://github.com/bitcoin/bitcoin.org.git","ssh_url":"git@github.com:bitcoin/bitcoin.org.git","clone_url":"https://github.com/bitcoin/bitcoin.org.git","svn_url":"https://github.com/bitcoin/bitcoin.org","homepage":"https://bitcoin.org/","size":31271,"stargazers_count":216,"watchers_count":216,"language":"HTML","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":328,"mirror_url":null,"open_issues_count":31,"forks":328,"open_issues":31,"watchers":216,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/bitcoin/bitcoin.org/pulls/823"},"html":{"href":"https://github.com/bitcoin/bitcoin.org/pull/823"},"issue":{"href":"https://api.github.com/repos/bitcoin/bitcoin.org/issues/823"},"comments":{"href":"https://api.github.com/repos/bitcoin/bitcoin.org/issues/823/comments"},"review_comments":{"href":"https://api.github.com/repos/bitcoin/bitcoin.org/pulls/823/comments"},"review_comment":{"href":"https://api.github.com/repos/bitcoin/bitcoin.org/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/bitcoin/bitcoin.org/pulls/823/commits"},"statuses":{"href":"https://api.github.com/repos/bitcoin/bitcoin.org/statuses/3eee4811fd2f0c407972d5f8112feb46dfcfe44a"}}}}