{"action":"created","comment":{"url":"https://api.github.com/repos/graphql/graphql.github.io/pulls/comments/75197052","id":75197052,"diff_hunk":"@@ -0,0 +1,174 @@\n+# New GraphQL.org Site Architecture:\n+\n+## Index\n+\n+*Goal:* This is the landing page and is our opportunity to quickly capture attention and explain what GraphQL is and why you should care.\n+\n+*Timeframe:* Launch Mon, Sept 12th\n+\n+This page is effectively a marketing page for GraphQL and should be the visual, scrollable version of the \"Introducing GraphQL\" conference talks and should be rich with visual metaphor and illustration and take advantage of whitespace to make individual salient points.\n+\n+Above the fold, this page should succinctly explain what GraphQL is and illustrate with a simple (editable) query/response example. Before scrolling you should understand the following:\n+\n+* GraphQL is an query language for APIs.\n+* GraphQL is sent by client applications, such as an iOS app.\n+* GraphQL is evaluated by a web service and often returned as JSON.\n+* GraphQL typically replaces REST.\n+\n+Below the fold we should introduce concepts one at a time, each with visual metaphor and take-aways:\n+\n+1) GraphQL describes what a client needs in terms of how client developers think about data.\n+\n+* If you're familiar with JSON, GraphQL is easy to learn and understand.\n+* It's easy to anticipate the shape of the result for any query.\n+* GraphQL only sends what you ask for, nothing more or less.","path":"notes/NewSiteArchitecture.md","position":24,"original_position":24,"commit_id":"cccb537c8d6a940684f752309050e226c444f4bb","original_commit_id":"cccb537c8d6a940684f752309050e226c444f4bb","user":{"login":"robzhu","id":2891215,"avatar_url":"https://avatars.githubusercontent.com/u/2891215?v=3","gravatar_id":"","url":"https://api.github.com/users/robzhu","html_url":"https://github.com/robzhu","followers_url":"https://api.github.com/users/robzhu/followers","following_url":"https://api.github.com/users/robzhu/following{/other_user}","gists_url":"https://api.github.com/users/robzhu/gists{/gist_id}","starred_url":"https://api.github.com/users/robzhu/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/robzhu/subscriptions","organizations_url":"https://api.github.com/users/robzhu/orgs","repos_url":"https://api.github.com/users/robzhu/repos","events_url":"https://api.github.com/users/robzhu/events{/privacy}","received_events_url":"https://api.github.com/users/robzhu/received_events","type":"User","site_admin":false},"body":"One common response to \"GraphQL can fetch all the data you need in a single request!\" is, \"then how does caching work?\". Should we attempt to head off that concern here?","created_at":"2016-08-17T20:11:05Z","updated_at":"2016-08-17T20:11:05Z","html_url":"https://github.com/graphql/graphql.github.io/pull/35#discussion_r75197052","pull_request_url":"https://api.github.com/repos/graphql/graphql.github.io/pulls/35","_links":{"self":{"href":"https://api.github.com/repos/graphql/graphql.github.io/pulls/comments/75197052"},"html":{"href":"https://github.com/graphql/graphql.github.io/pull/35#discussion_r75197052"},"pull_request":{"href":"https://api.github.com/repos/graphql/graphql.github.io/pulls/35"}}},"pull_request":{"url":"https://api.github.com/repos/graphql/graphql.github.io/pulls/35","id":81581909,"html_url":"https://github.com/graphql/graphql.github.io/pull/35","diff_url":"https://github.com/graphql/graphql.github.io/pull/35.diff","patch_url":"https://github.com/graphql/graphql.github.io/pull/35.patch","issue_url":"https://api.github.com/repos/graphql/graphql.github.io/issues/35","number":35,"state":"open","locked":false,"title":"Straw-man for new site architecture","user":{"login":"leebyron","id":50130,"avatar_url":"https://avatars.githubusercontent.com/u/50130?v=3","gravatar_id":"","url":"https://api.github.com/users/leebyron","html_url":"https://github.com/leebyron","followers_url":"https://api.github.com/users/leebyron/followers","following_url":"https://api.github.com/users/leebyron/following{/other_user}","gists_url":"https://api.github.com/users/leebyron/gists{/gist_id}","starred_url":"https://api.github.com/users/leebyron/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/leebyron/subscriptions","organizations_url":"https://api.github.com/users/leebyron/orgs","repos_url":"https://api.github.com/users/leebyron/repos","events_url":"https://api.github.com/users/leebyron/events{/privacy}","received_events_url":"https://api.github.com/users/leebyron/received_events","type":"User","site_admin":false},"body":"This is a straw-man outline for an improved version of graphql.org. The content on graphql.org has evolved only slightly since it was launched a year ago, and a lot has changed since then. In order to continue to serve its purpose as an education hub for GraphQL, it needs to improve both in design and content.\r\n\r\nThis document serves as a list of goals and (aggressive) timeframes for each section of the site along with a moderately detailed framing of the content for those pages. What is less captured by this document but equally important is a visual refresh that results in content that is easier to navigate and consume.\r\n\r\nI'm sharing this here as a PR as an opportunity for folks to comment inline.","created_at":"2016-08-17T04:16:11Z","updated_at":"2016-08-17T20:11:05Z","closed_at":null,"merged_at":null,"merge_commit_sha":"78743a33d7614375feb1012fc8167b52b884e86c","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/graphql/graphql.github.io/pulls/35/commits","review_comments_url":"https://api.github.com/repos/graphql/graphql.github.io/pulls/35/comments","review_comment_url":"https://api.github.com/repos/graphql/graphql.github.io/pulls/comments{/number}","comments_url":"https://api.github.com/repos/graphql/graphql.github.io/issues/35/comments","statuses_url":"https://api.github.com/repos/graphql/graphql.github.io/statuses/cccb537c8d6a940684f752309050e226c444f4bb","head":{"label":"graphql:new-site","ref":"new-site","sha":"cccb537c8d6a940684f752309050e226c444f4bb","user":{"login":"graphql","id":12972006,"avatar_url":"https://avatars.githubusercontent.com/u/12972006?v=3","gravatar_id":"","url":"https://api.github.com/users/graphql","html_url":"https://github.com/graphql","followers_url":"https://api.github.com/users/graphql/followers","following_url":"https://api.github.com/users/graphql/following{/other_user}","gists_url":"https://api.github.com/users/graphql/gists{/gist_id}","starred_url":"https://api.github.com/users/graphql/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/graphql/subscriptions","organizations_url":"https://api.github.com/users/graphql/orgs","repos_url":"https://api.github.com/users/graphql/repos","events_url":"https://api.github.com/users/graphql/events{/privacy}","received_events_url":"https://api.github.com/users/graphql/received_events","type":"Organization","site_admin":false},"repo":{"id":41887215,"name":"graphql.github.io","full_name":"graphql/graphql.github.io","owner":{"login":"graphql","id":12972006,"avatar_url":"https://avatars.githubusercontent.com/u/12972006?v=3","gravatar_id":"","url":"https://api.github.com/users/graphql","html_url":"https://github.com/graphql","followers_url":"https://api.github.com/users/graphql/followers","following_url":"https://api.github.com/users/graphql/following{/other_user}","gists_url":"https://api.github.com/users/graphql/gists{/gist_id}","starred_url":"https://api.github.com/users/graphql/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/graphql/subscriptions","organizations_url":"https://api.github.com/users/graphql/orgs","repos_url":"https://api.github.com/users/graphql/repos","events_url":"https://api.github.com/users/graphql/events{/privacy}","received_events_url":"https://api.github.com/users/graphql/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/graphql/graphql.github.io","description":"GraphQL Documentation at graphql.org","fork":false,"url":"https://api.github.com/repos/graphql/graphql.github.io","forks_url":"https://api.github.com/repos/graphql/graphql.github.io/forks","keys_url":"https://api.github.com/repos/graphql/graphql.github.io/keys{/key_id}","collaborators_url":"https://api.github.com/repos/graphql/graphql.github.io/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/graphql/graphql.github.io/teams","hooks_url":"https://api.github.com/repos/graphql/graphql.github.io/hooks","issue_events_url":"https://api.github.com/repos/graphql/graphql.github.io/issues/events{/number}","events_url":"https://api.github.com/repos/graphql/graphql.github.io/events","assignees_url":"https://api.github.com/repos/graphql/graphql.github.io/assignees{/user}","branches_url":"https://api.github.com/repos/graphql/graphql.github.io/branches{/branch}","tags_url":"https://api.github.com/repos/graphql/graphql.github.io/tags","blobs_url":"https://api.github.com/repos/graphql/graphql.github.io/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/graphql/graphql.github.io/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/graphql/graphql.github.io/git/refs{/sha}","trees_url":"https://api.github.com/repos/graphql/graphql.github.io/git/trees{/sha}","statuses_url":"https://api.github.com/repos/graphql/graphql.github.io/statuses/{sha}","languages_url":"https://api.github.com/repos/graphql/graphql.github.io/languages","stargazers_url":"https://api.github.com/repos/graphql/graphql.github.io/stargazers","contributors_url":"https://api.github.com/repos/graphql/graphql.github.io/contributors","subscribers_url":"https://api.github.com/repos/graphql/graphql.github.io/subscribers","subscription_url":"https://api.github.com/repos/graphql/graphql.github.io/subscription","commits_url":"https://api.github.com/repos/graphql/graphql.github.io/commits{/sha}","git_commits_url":"https://api.github.com/repos/graphql/graphql.github.io/git/commits{/sha}","comments_url":"https://api.github.com/repos/graphql/graphql.github.io/comments{/number}","issue_comment_url":"https://api.github.com/repos/graphql/graphql.github.io/issues/comments{/number}","contents_url":"https://api.github.com/repos/graphql/graphql.github.io/contents/{+path}","compare_url":"https://api.github.com/repos/graphql/graphql.github.io/compare/{base}...{head}","merges_url":"https://api.github.com/repos/graphql/graphql.github.io/merges","archive_url":"https://api.github.com/repos/graphql/graphql.github.io/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/graphql/graphql.github.io/downloads","issues_url":"https://api.github.com/repos/graphql/graphql.github.io/issues{/number}","pulls_url":"https://api.github.com/repos/graphql/graphql.github.io/pulls{/number}","milestones_url":"https://api.github.com/repos/graphql/graphql.github.io/milestones{/number}","notifications_url":"https://api.github.com/repos/graphql/graphql.github.io/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/graphql/graphql.github.io/labels{/name}","releases_url":"https://api.github.com/repos/graphql/graphql.github.io/releases{/id}","deployments_url":"https://api.github.com/repos/graphql/graphql.github.io/deployments","created_at":"2015-09-03T22:40:02Z","updated_at":"2016-07-17T17:04:31Z","pushed_at":"2016-08-17T04:17:25Z","git_url":"git://github.com/graphql/graphql.github.io.git","ssh_url":"git@github.com:graphql/graphql.github.io.git","clone_url":"https://github.com/graphql/graphql.github.io.git","svn_url":"https://github.com/graphql/graphql.github.io","homepage":null,"size":810,"stargazers_count":17,"watchers_count":17,"language":"JavaScript","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":33,"mirror_url":null,"open_issues_count":3,"forks":33,"open_issues":3,"watchers":17,"default_branch":"source"}},"base":{"label":"graphql:source","ref":"source","sha":"22d0a687bcbd9725e3e9a59fc688e0095d07f321","user":{"login":"graphql","id":12972006,"avatar_url":"https://avatars.githubusercontent.com/u/12972006?v=3","gravatar_id":"","url":"https://api.github.com/users/graphql","html_url":"https://github.com/graphql","followers_url":"https://api.github.com/users/graphql/followers","following_url":"https://api.github.com/users/graphql/following{/other_user}","gists_url":"https://api.github.com/users/graphql/gists{/gist_id}","starred_url":"https://api.github.com/users/graphql/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/graphql/subscriptions","organizations_url":"https://api.github.com/users/graphql/orgs","repos_url":"https://api.github.com/users/graphql/repos","events_url":"https://api.github.com/users/graphql/events{/privacy}","received_events_url":"https://api.github.com/users/graphql/received_events","type":"Organization","site_admin":false},"repo":{"id":41887215,"name":"graphql.github.io","full_name":"graphql/graphql.github.io","owner":{"login":"graphql","id":12972006,"avatar_url":"https://avatars.githubusercontent.com/u/12972006?v=3","gravatar_id":"","url":"https://api.github.com/users/graphql","html_url":"https://github.com/graphql","followers_url":"https://api.github.com/users/graphql/followers","following_url":"https://api.github.com/users/graphql/following{/other_user}","gists_url":"https://api.github.com/users/graphql/gists{/gist_id}","starred_url":"https://api.github.com/users/graphql/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/graphql/subscriptions","organizations_url":"https://api.github.com/users/graphql/orgs","repos_url":"https://api.github.com/users/graphql/repos","events_url":"https://api.github.com/users/graphql/events{/privacy}","received_events_url":"https://api.github.com/users/graphql/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/graphql/graphql.github.io","description":"GraphQL Documentation at graphql.org","fork":false,"url":"https://api.github.com/repos/graphql/graphql.github.io","forks_url":"https://api.github.com/repos/graphql/graphql.github.io/forks","keys_url":"https://api.github.com/repos/graphql/graphql.github.io/keys{/key_id}","collaborators_url":"https://api.github.com/repos/graphql/graphql.github.io/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/graphql/graphql.github.io/teams","hooks_url":"https://api.github.com/repos/graphql/graphql.github.io/hooks","issue_events_url":"https://api.github.com/repos/graphql/graphql.github.io/issues/events{/number}","events_url":"https://api.github.com/repos/graphql/graphql.github.io/events","assignees_url":"https://api.github.com/repos/graphql/graphql.github.io/assignees{/user}","branches_url":"https://api.github.com/repos/graphql/graphql.github.io/branches{/branch}","tags_url":"https://api.github.com/repos/graphql/graphql.github.io/tags","blobs_url":"https://api.github.com/repos/graphql/graphql.github.io/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/graphql/graphql.github.io/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/graphql/graphql.github.io/git/refs{/sha}","trees_url":"https://api.github.com/repos/graphql/graphql.github.io/git/trees{/sha}","statuses_url":"https://api.github.com/repos/graphql/graphql.github.io/statuses/{sha}","languages_url":"https://api.github.com/repos/graphql/graphql.github.io/languages","stargazers_url":"https://api.github.com/repos/graphql/graphql.github.io/stargazers","contributors_url":"https://api.github.com/repos/graphql/graphql.github.io/contributors","subscribers_url":"https://api.github.com/repos/graphql/graphql.github.io/subscribers","subscription_url":"https://api.github.com/repos/graphql/graphql.github.io/subscription","commits_url":"https://api.github.com/repos/graphql/graphql.github.io/commits{/sha}","git_commits_url":"https://api.github.com/repos/graphql/graphql.github.io/git/commits{/sha}","comments_url":"https://api.github.com/repos/graphql/graphql.github.io/comments{/number}","issue_comment_url":"https://api.github.com/repos/graphql/graphql.github.io/issues/comments{/number}","contents_url":"https://api.github.com/repos/graphql/graphql.github.io/contents/{+path}","compare_url":"https://api.github.com/repos/graphql/graphql.github.io/compare/{base}...{head}","merges_url":"https://api.github.com/repos/graphql/graphql.github.io/merges","archive_url":"https://api.github.com/repos/graphql/graphql.github.io/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/graphql/graphql.github.io/downloads","issues_url":"https://api.github.com/repos/graphql/graphql.github.io/issues{/number}","pulls_url":"https://api.github.com/repos/graphql/graphql.github.io/pulls{/number}","milestones_url":"https://api.github.com/repos/graphql/graphql.github.io/milestones{/number}","notifications_url":"https://api.github.com/repos/graphql/graphql.github.io/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/graphql/graphql.github.io/labels{/name}","releases_url":"https://api.github.com/repos/graphql/graphql.github.io/releases{/id}","deployments_url":"https://api.github.com/repos/graphql/graphql.github.io/deployments","created_at":"2015-09-03T22:40:02Z","updated_at":"2016-07-17T17:04:31Z","pushed_at":"2016-08-17T04:17:25Z","git_url":"git://github.com/graphql/graphql.github.io.git","ssh_url":"git@github.com:graphql/graphql.github.io.git","clone_url":"https://github.com/graphql/graphql.github.io.git","svn_url":"https://github.com/graphql/graphql.github.io","homepage":null,"size":810,"stargazers_count":17,"watchers_count":17,"language":"JavaScript","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":33,"mirror_url":null,"open_issues_count":3,"forks":33,"open_issues":3,"watchers":17,"default_branch":"source"}},"_links":{"self":{"href":"https://api.github.com/repos/graphql/graphql.github.io/pulls/35"},"html":{"href":"https://github.com/graphql/graphql.github.io/pull/35"},"issue":{"href":"https://api.github.com/repos/graphql/graphql.github.io/issues/35"},"comments":{"href":"https://api.github.com/repos/graphql/graphql.github.io/issues/35/comments"},"review_comments":{"href":"https://api.github.com/repos/graphql/graphql.github.io/pulls/35/comments"},"review_comment":{"href":"https://api.github.com/repos/graphql/graphql.github.io/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/graphql/graphql.github.io/pulls/35/commits"},"statuses":{"href":"https://api.github.com/repos/graphql/graphql.github.io/statuses/cccb537c8d6a940684f752309050e226c444f4bb"}}}}
{"actor":{"display_login":"robzhu"}}