{"action":"created","comment":{"url":"https://api.github.com/repos/Financial-Times/ft-origami/pulls/comments/59894703","id":59894703,"diff_hunk":"@@ -1,25 +1,26 @@\n ---\n layout: default\n-title: Installing modules manually\n-section: Developer guide\n-permalink: /docs/developer-guide/building-modules/\n+title: Manual build process guide\n+section: Modules\n+permalink: /docs/developer-guide/modules/building-modules/\n site_section: developer-guide\n+redirect_from: \"/docs/developer-guide/building-modules/\"\n ---\n \n-# Building Origami modules into your product\n+<h1>Manual build process <span class=\"o-labels o-labels--big\">Tutorial</span></h1>\n \n-Building Origami modules manually gives you the most flexibility and control, but you will need to use some specific tools.  Remember that in many cases you may be able to get started faster by using the [build service](../build-service), which will do all this for you.\n+Building Origami modules manually gives you the most flexibility and control, but you will need to use some specific tools.  Remember that in many cases you may be able to get started faster by using the [Build Service](../build-service), which will do all this for you.\n \n-This tutorial assumes you are starting from a fresh install of a UNIX-like OS with a bash shell and have cloned or initalised a git repo for your project somewhere on the filesystem.  If you're a bit further along than that, feel free to skip any steps you've already completed.\n+This tutorial assumes you're starting from a fresh install of a UNIX-like OS with a bash shell and have cloned or initalised a git repo for your project somewhere on the filesystem.  If you're a bit further along than that, feel free to skip any steps you've already completed.\n \n <aside>\n \t<h4>No support for Windows</h4>\n-\t<p>Origami's build tools do not support Windows as a development environment and the instructions on this page assume you are using a UNIX-like OS.  Windows <strong>might</strong> work, to some degree, but we don't make any guarantees, either of what works today or what might continue to work in the future.  If you're a Windows user, consider running a Linux VM.</p>\n+\t<p>Origami's build tools do not support Windows as a development environment. The instructions on this page assume you are using a UNIX-like OS.  Windows <strong>might</strong> work, to some degree, but we don't make any guarantees, either of what works today or what might continue to work in the future.  If you're a Windows user, consider running a Linux VM.</p>\n </aside>\n \n ## 1. Install Node.js, Ruby and Git\n \n-To use Origami components, you need two language runtimes (it doesn't matter if you are not writing your application in Node or Ruby, you still need to install them) and the <code>git(1)</code> version control system:\n+To build Origami modules manually, you'll need Ruby, Node and git. It doesn't matter if you're not writing your application in Node or Ruby, you still need to install them for this.","path":"docs/developer-guide/building-modules.md","position":31,"original_position":31,"commit_id":"8164262a93068ef0918dd69c502044c850b4e383","original_commit_id":"8164262a93068ef0918dd69c502044c850b4e383","user":{"login":"onishiweb","id":1240073,"avatar_url":"https://avatars.githubusercontent.com/u/1240073?v=3","gravatar_id":"","url":"https://api.github.com/users/onishiweb","html_url":"https://github.com/onishiweb","followers_url":"https://api.github.com/users/onishiweb/followers","following_url":"https://api.github.com/users/onishiweb/following{/other_user}","gists_url":"https://api.github.com/users/onishiweb/gists{/gist_id}","starred_url":"https://api.github.com/users/onishiweb/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/onishiweb/subscriptions","organizations_url":"https://api.github.com/users/onishiweb/orgs","repos_url":"https://api.github.com/users/onishiweb/repos","events_url":"https://api.github.com/users/onishiweb/events{/privacy}","received_events_url":"https://api.github.com/users/onishiweb/received_events","type":"User","site_admin":false},"body":"Capitalise `Git`\r\n\r\nAnd Oxford comma? `Ruby, Node, and Git`","created_at":"2016-04-15T15:42:44Z","updated_at":"2016-04-15T15:42:44Z","html_url":"https://github.com/Financial-Times/ft-origami/pull/470#discussion_r59894703","pull_request_url":"https://api.github.com/repos/Financial-Times/ft-origami/pulls/470","_links":{"self":{"href":"https://api.github.com/repos/Financial-Times/ft-origami/pulls/comments/59894703"},"html":{"href":"https://github.com/Financial-Times/ft-origami/pull/470#discussion_r59894703"},"pull_request":{"href":"https://api.github.com/repos/Financial-Times/ft-origami/pulls/470"}}},"pull_request":{"url":"https://api.github.com/repos/Financial-Times/ft-origami/pulls/470","id":66622977,"html_url":"https://github.com/Financial-Times/ft-origami/pull/470","diff_url":"https://github.com/Financial-Times/ft-origami/pull/470.diff","patch_url":"https://github.com/Financial-Times/ft-origami/pull/470.patch","issue_url":"https://api.github.com/repos/Financial-Times/ft-origami/issues/470","number":470,"state":"open","locked":false,"title":"Re-write documentation","user":{"login":"alicebartlett","id":68009,"avatar_url":"https://avatars.githubusercontent.com/u/68009?v=3","gravatar_id":"","url":"https://api.github.com/users/alicebartlett","html_url":"https://github.com/alicebartlett","followers_url":"https://api.github.com/users/alicebartlett/followers","following_url":"https://api.github.com/users/alicebartlett/following{/other_user}","gists_url":"https://api.github.com/users/alicebartlett/gists{/gist_id}","starred_url":"https://api.github.com/users/alicebartlett/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/alicebartlett/subscriptions","organizations_url":"https://api.github.com/users/alicebartlett/orgs","repos_url":"https://api.github.com/users/alicebartlett/repos","events_url":"https://api.github.com/users/alicebartlett/events{/privacy}","received_events_url":"https://api.github.com/users/alicebartlett/received_events","type":"User","site_admin":false},"body":"This is not my finest git work. Basically I got into a huge tangle with this and then decided that instead of spending half a day rebasing it into a followable history I'd just call git bankruptcy and squash nearly everything into a single commit (sorry!)\r\n\r\n## What's in this pr\r\n1. Re-organisation of pages. I've added more structure to help people find things\r\n2. New pages! For some topics: CTM, polyfilling, JS initialising and module versioning. Some of these are stubs to be filled in later. \r\n3. A new \"quick start\" page\r\n4. 'Introduction' is now just 'how to use this documentation'\r\n5. General grammar and style improvements. I've tried to simplify the english to comply with our style guide\r\n\r\n## How to review this\r\n- Check out the code and run it locally\r\n- There are 11 pages here that just need reading and checking from a proof reading perspective. Perhaps we could divide this work up. Things to check for: typos, spelling errors, broken links, things that are badly explained, does the reader know what to expect from document.\r\n\r\n4 of these pages are unfinished. I want to finish these in a later commit, but Im not to bothered about shipping them in their unfinished state. Once this behemoth of a change is out, finishing individual pages like these will be trivial.\r\n\r\n- [x] /docs/developer-guide/\r\n- [ ] /docs/developer-guide/modules/\r\n- [x] /docs/developer-guide/modules/very-quick-origami/\r\n- [x] /docs/developer-guide/modules/choosing-your-build-method/\r\n- [x] /docs/developer-guide/modules/build-service/\r\n- [ ] /docs/developer-guide/modules/building-modules/\r\n- [ ] /docs/developer-guide/modules/initialising-modules/ @AlbertoElias  can you do this one?\r\n- [x] /docs/developer-guide/modules/core-vs-enhanced-experience/ (unfinished)\r\n- [x] /docs/developer-guide/modules/module-versioning/ (unfinished)\r\n- [ ] /docs/developer-guide/modules/using-the-polyfill-service/ (unfinished)\r\n- [x] /docs/developer-guide/web-services/\r\n- [x] /docs/developer-guide/general-best-practices/\r\n\r\n","created_at":"2016-04-15T10:41:09Z","updated_at":"2016-04-15T15:42:44Z","closed_at":null,"merged_at":null,"merge_commit_sha":"726454a270acdca34d6d16f2fd2143e1dc3dabb8","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/Financial-Times/ft-origami/pulls/470/commits","review_comments_url":"https://api.github.com/repos/Financial-Times/ft-origami/pulls/470/comments","review_comment_url":"https://api.github.com/repos/Financial-Times/ft-origami/pulls/comments{/number}","comments_url":"https://api.github.com/repos/Financial-Times/ft-origami/issues/470/comments","statuses_url":"https://api.github.com/repos/Financial-Times/ft-origami/statuses/8164262a93068ef0918dd69c502044c850b4e383","head":{"label":"Financial-Times:history-fiddle","ref":"history-fiddle","sha":"8164262a93068ef0918dd69c502044c850b4e383","user":{"login":"Financial-Times","id":3502508,"avatar_url":"https://avatars.githubusercontent.com/u/3502508?v=3","gravatar_id":"","url":"https://api.github.com/users/Financial-Times","html_url":"https://github.com/Financial-Times","followers_url":"https://api.github.com/users/Financial-Times/followers","following_url":"https://api.github.com/users/Financial-Times/following{/other_user}","gists_url":"https://api.github.com/users/Financial-Times/gists{/gist_id}","starred_url":"https://api.github.com/users/Financial-Times/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Financial-Times/subscriptions","organizations_url":"https://api.github.com/users/Financial-Times/orgs","repos_url":"https://api.github.com/users/Financial-Times/repos","events_url":"https://api.github.com/users/Financial-Times/events{/privacy}","received_events_url":"https://api.github.com/users/Financial-Times/received_events","type":"Organization","site_admin":false},"repo":{"id":11848885,"name":"ft-origami","full_name":"Financial-Times/ft-origami","owner":{"login":"Financial-Times","id":3502508,"avatar_url":"https://avatars.githubusercontent.com/u/3502508?v=3","gravatar_id":"","url":"https://api.github.com/users/Financial-Times","html_url":"https://github.com/Financial-Times","followers_url":"https://api.github.com/users/Financial-Times/followers","following_url":"https://api.github.com/users/Financial-Times/following{/other_user}","gists_url":"https://api.github.com/users/Financial-Times/gists{/gist_id}","starred_url":"https://api.github.com/users/Financial-Times/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Financial-Times/subscriptions","organizations_url":"https://api.github.com/users/Financial-Times/orgs","repos_url":"https://api.github.com/users/Financial-Times/repos","events_url":"https://api.github.com/users/Financial-Times/events{/privacy}","received_events_url":"https://api.github.com/users/Financial-Times/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/Financial-Times/ft-origami","description":"Universal front end component standards for FT web products","fork":false,"url":"https://api.github.com/repos/Financial-Times/ft-origami","forks_url":"https://api.github.com/repos/Financial-Times/ft-origami/forks","keys_url":"https://api.github.com/repos/Financial-Times/ft-origami/keys{/key_id}","collaborators_url":"https://api.github.com/repos/Financial-Times/ft-origami/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/Financial-Times/ft-origami/teams","hooks_url":"https://api.github.com/repos/Financial-Times/ft-origami/hooks","issue_events_url":"https://api.github.com/repos/Financial-Times/ft-origami/issues/events{/number}","events_url":"https://api.github.com/repos/Financial-Times/ft-origami/events","assignees_url":"https://api.github.com/repos/Financial-Times/ft-origami/assignees{/user}","branches_url":"https://api.github.com/repos/Financial-Times/ft-origami/branches{/branch}","tags_url":"https://api.github.com/repos/Financial-Times/ft-origami/tags","blobs_url":"https://api.github.com/repos/Financial-Times/ft-origami/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/Financial-Times/ft-origami/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/Financial-Times/ft-origami/git/refs{/sha}","trees_url":"https://api.github.com/repos/Financial-Times/ft-origami/git/trees{/sha}","statuses_url":"https://api.github.com/repos/Financial-Times/ft-origami/statuses/{sha}","languages_url":"https://api.github.com/repos/Financial-Times/ft-origami/languages","stargazers_url":"https://api.github.com/repos/Financial-Times/ft-origami/stargazers","contributors_url":"https://api.github.com/repos/Financial-Times/ft-origami/contributors","subscribers_url":"https://api.github.com/repos/Financial-Times/ft-origami/subscribers","subscription_url":"https://api.github.com/repos/Financial-Times/ft-origami/subscription","commits_url":"https://api.github.com/repos/Financial-Times/ft-origami/commits{/sha}","git_commits_url":"https://api.github.com/repos/Financial-Times/ft-origami/git/commits{/sha}","comments_url":"https://api.github.com/repos/Financial-Times/ft-origami/comments{/number}","issue_comment_url":"https://api.github.com/repos/Financial-Times/ft-origami/issues/comments{/number}","contents_url":"https://api.github.com/repos/Financial-Times/ft-origami/contents/{+path}","compare_url":"https://api.github.com/repos/Financial-Times/ft-origami/compare/{base}...{head}","merges_url":"https://api.github.com/repos/Financial-Times/ft-origami/merges","archive_url":"https://api.github.com/repos/Financial-Times/ft-origami/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/Financial-Times/ft-origami/downloads","issues_url":"https://api.github.com/repos/Financial-Times/ft-origami/issues{/number}","pulls_url":"https://api.github.com/repos/Financial-Times/ft-origami/pulls{/number}","milestones_url":"https://api.github.com/repos/Financial-Times/ft-origami/milestones{/number}","notifications_url":"https://api.github.com/repos/Financial-Times/ft-origami/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/Financial-Times/ft-origami/labels{/name}","releases_url":"https://api.github.com/repos/Financial-Times/ft-origami/releases{/id}","deployments_url":"https://api.github.com/repos/Financial-Times/ft-origami/deployments","created_at":"2013-08-02T17:36:44Z","updated_at":"2016-03-26T03:45:45Z","pushed_at":"2016-04-15T15:37:23Z","git_url":"git://github.com/Financial-Times/ft-origami.git","ssh_url":"git@github.com:Financial-Times/ft-origami.git","clone_url":"https://github.com/Financial-Times/ft-origami.git","svn_url":"https://github.com/Financial-Times/ft-origami","homepage":"http://origami.ft.com/","size":6444,"stargazers_count":46,"watchers_count":46,"language":"HTML","has_issues":true,"has_downloads":false,"has_wiki":false,"has_pages":true,"forks_count":9,"mirror_url":null,"open_issues_count":24,"forks":9,"open_issues":24,"watchers":46,"default_branch":"gh-pages"}},"base":{"label":"Financial-Times:gh-pages","ref":"gh-pages","sha":"88cbff42ec09361c6f88ad331c7f50179758f5a6","user":{"login":"Financial-Times","id":3502508,"avatar_url":"https://avatars.githubusercontent.com/u/3502508?v=3","gravatar_id":"","url":"https://api.github.com/users/Financial-Times","html_url":"https://github.com/Financial-Times","followers_url":"https://api.github.com/users/Financial-Times/followers","following_url":"https://api.github.com/users/Financial-Times/following{/other_user}","gists_url":"https://api.github.com/users/Financial-Times/gists{/gist_id}","starred_url":"https://api.github.com/users/Financial-Times/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Financial-Times/subscriptions","organizations_url":"https://api.github.com/users/Financial-Times/orgs","repos_url":"https://api.github.com/users/Financial-Times/repos","events_url":"https://api.github.com/users/Financial-Times/events{/privacy}","received_events_url":"https://api.github.com/users/Financial-Times/received_events","type":"Organization","site_admin":false},"repo":{"id":11848885,"name":"ft-origami","full_name":"Financial-Times/ft-origami","owner":{"login":"Financial-Times","id":3502508,"avatar_url":"https://avatars.githubusercontent.com/u/3502508?v=3","gravatar_id":"","url":"https://api.github.com/users/Financial-Times","html_url":"https://github.com/Financial-Times","followers_url":"https://api.github.com/users/Financial-Times/followers","following_url":"https://api.github.com/users/Financial-Times/following{/other_user}","gists_url":"https://api.github.com/users/Financial-Times/gists{/gist_id}","starred_url":"https://api.github.com/users/Financial-Times/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Financial-Times/subscriptions","organizations_url":"https://api.github.com/users/Financial-Times/orgs","repos_url":"https://api.github.com/users/Financial-Times/repos","events_url":"https://api.github.com/users/Financial-Times/events{/privacy}","received_events_url":"https://api.github.com/users/Financial-Times/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/Financial-Times/ft-origami","description":"Universal front end component standards for FT web products","fork":false,"url":"https://api.github.com/repos/Financial-Times/ft-origami","forks_url":"https://api.github.com/repos/Financial-Times/ft-origami/forks","keys_url":"https://api.github.com/repos/Financial-Times/ft-origami/keys{/key_id}","collaborators_url":"https://api.github.com/repos/Financial-Times/ft-origami/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/Financial-Times/ft-origami/teams","hooks_url":"https://api.github.com/repos/Financial-Times/ft-origami/hooks","issue_events_url":"https://api.github.com/repos/Financial-Times/ft-origami/issues/events{/number}","events_url":"https://api.github.com/repos/Financial-Times/ft-origami/events","assignees_url":"https://api.github.com/repos/Financial-Times/ft-origami/assignees{/user}","branches_url":"https://api.github.com/repos/Financial-Times/ft-origami/branches{/branch}","tags_url":"https://api.github.com/repos/Financial-Times/ft-origami/tags","blobs_url":"https://api.github.com/repos/Financial-Times/ft-origami/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/Financial-Times/ft-origami/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/Financial-Times/ft-origami/git/refs{/sha}","trees_url":"https://api.github.com/repos/Financial-Times/ft-origami/git/trees{/sha}","statuses_url":"https://api.github.com/repos/Financial-Times/ft-origami/statuses/{sha}","languages_url":"https://api.github.com/repos/Financial-Times/ft-origami/languages","stargazers_url":"https://api.github.com/repos/Financial-Times/ft-origami/stargazers","contributors_url":"https://api.github.com/repos/Financial-Times/ft-origami/contributors","subscribers_url":"https://api.github.com/repos/Financial-Times/ft-origami/subscribers","subscription_url":"https://api.github.com/repos/Financial-Times/ft-origami/subscription","commits_url":"https://api.github.com/repos/Financial-Times/ft-origami/commits{/sha}","git_commits_url":"https://api.github.com/repos/Financial-Times/ft-origami/git/commits{/sha}","comments_url":"https://api.github.com/repos/Financial-Times/ft-origami/comments{/number}","issue_comment_url":"https://api.github.com/repos/Financial-Times/ft-origami/issues/comments{/number}","contents_url":"https://api.github.com/repos/Financial-Times/ft-origami/contents/{+path}","compare_url":"https://api.github.com/repos/Financial-Times/ft-origami/compare/{base}...{head}","merges_url":"https://api.github.com/repos/Financial-Times/ft-origami/merges","archive_url":"https://api.github.com/repos/Financial-Times/ft-origami/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/Financial-Times/ft-origami/downloads","issues_url":"https://api.github.com/repos/Financial-Times/ft-origami/issues{/number}","pulls_url":"https://api.github.com/repos/Financial-Times/ft-origami/pulls{/number}","milestones_url":"https://api.github.com/repos/Financial-Times/ft-origami/milestones{/number}","notifications_url":"https://api.github.com/repos/Financial-Times/ft-origami/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/Financial-Times/ft-origami/labels{/name}","releases_url":"https://api.github.com/repos/Financial-Times/ft-origami/releases{/id}","deployments_url":"https://api.github.com/repos/Financial-Times/ft-origami/deployments","created_at":"2013-08-02T17:36:44Z","updated_at":"2016-03-26T03:45:45Z","pushed_at":"2016-04-15T15:37:23Z","git_url":"git://github.com/Financial-Times/ft-origami.git","ssh_url":"git@github.com:Financial-Times/ft-origami.git","clone_url":"https://github.com/Financial-Times/ft-origami.git","svn_url":"https://github.com/Financial-Times/ft-origami","homepage":"http://origami.ft.com/","size":6444,"stargazers_count":46,"watchers_count":46,"language":"HTML","has_issues":true,"has_downloads":false,"has_wiki":false,"has_pages":true,"forks_count":9,"mirror_url":null,"open_issues_count":24,"forks":9,"open_issues":24,"watchers":46,"default_branch":"gh-pages"}},"_links":{"self":{"href":"https://api.github.com/repos/Financial-Times/ft-origami/pulls/470"},"html":{"href":"https://github.com/Financial-Times/ft-origami/pull/470"},"issue":{"href":"https://api.github.com/repos/Financial-Times/ft-origami/issues/470"},"comments":{"href":"https://api.github.com/repos/Financial-Times/ft-origami/issues/470/comments"},"review_comments":{"href":"https://api.github.com/repos/Financial-Times/ft-origami/pulls/470/comments"},"review_comment":{"href":"https://api.github.com/repos/Financial-Times/ft-origami/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/Financial-Times/ft-origami/pulls/470/commits"},"statuses":{"href":"https://api.github.com/repos/Financial-Times/ft-origami/statuses/8164262a93068ef0918dd69c502044c850b4e383"}}}}