{"action":"created","comment":{"url":"https://api.github.com/repos/18F/frontend/pulls/comments/52207725","id":52207725,"diff_hunk":"@@ -0,0 +1,62 @@\n+# Table of Contents\n+- id: intro\n+  title: Introduction\n+\n+- id: concepts\n+  title: Core Concepts\n+  children:\n+\n+    - id: progressive-enhancement\n+      title: Progressive Enhancement\n+\n+    - id: modularity\n+      title: Modular Design\n+\n+    - id: web-standards\n+      title: Web Standards\n+\n+    - id: style-guides\n+      title: Style Guides\n+\n+    - id: frameworks\n+      title: Frameworks\n+\n+- id: technical\n+  title: Technical Guides\n+  children:\n+\n+    - id: html\n+      title: HTML\n+\n+    - id: css\n+      title: CSS\n+      children:\n+\n+        - id: css/architecture","path":"_data/chapters.yml","position":35,"original_position":35,"commit_id":"e584341d10d6aaf18664a5d29fb9e5f21a9844ba","original_commit_id":"e584341d10d6aaf18664a5d29fb9e5f21a9844ba","user":{"login":"shawnbot","id":113896,"avatar_url":"https://avatars.githubusercontent.com/u/113896?v=3","gravatar_id":"","url":"https://api.github.com/users/shawnbot","html_url":"https://github.com/shawnbot","followers_url":"https://api.github.com/users/shawnbot/followers","following_url":"https://api.github.com/users/shawnbot/following{/other_user}","gists_url":"https://api.github.com/users/shawnbot/gists{/gist_id}","starred_url":"https://api.github.com/users/shawnbot/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/shawnbot/subscriptions","organizations_url":"https://api.github.com/users/shawnbot/orgs","repos_url":"https://api.github.com/users/shawnbot/repos","events_url":"https://api.github.com/users/shawnbot/events{/privacy}","received_events_url":"https://api.github.com/users/shawnbot/received_events","type":"User","site_admin":false},"body":"Yep, definitely. I wanted to get the skeleton wired up before porting over all of the other content. There are a couple of other sections missing from the proposed structure, too.","created_at":"2016-02-08T18:48:06Z","updated_at":"2016-02-08T18:48:06Z","html_url":"https://github.com/18F/frontend/pull/97#discussion_r52207725","pull_request_url":"https://api.github.com/repos/18F/frontend/pulls/97","_links":{"self":{"href":"https://api.github.com/repos/18F/frontend/pulls/comments/52207725"},"html":{"href":"https://github.com/18F/frontend/pull/97#discussion_r52207725"},"pull_request":{"href":"https://api.github.com/repos/18F/frontend/pulls/97"}}},"pull_request":{"url":"https://api.github.com/repos/18F/frontend/pulls/97","id":58502149,"html_url":"https://github.com/18F/frontend/pull/97","diff_url":"https://github.com/18F/frontend/pull/97.diff","patch_url":"https://github.com/18F/frontend/pull/97.patch","issue_url":"https://api.github.com/repos/18F/frontend/issues/97","number":97,"state":"open","locked":false,"title":"[WIP] Restructure as single-page document","user":{"login":"shawnbot","id":113896,"avatar_url":"https://avatars.githubusercontent.com/u/113896?v=3","gravatar_id":"","url":"https://api.github.com/users/shawnbot","html_url":"https://github.com/shawnbot","followers_url":"https://api.github.com/users/shawnbot/followers","following_url":"https://api.github.com/users/shawnbot/following{/other_user}","gists_url":"https://api.github.com/users/shawnbot/gists{/gist_id}","starred_url":"https://api.github.com/users/shawnbot/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/shawnbot/subscriptions","organizations_url":"https://api.github.com/users/shawnbot/orgs","repos_url":"https://api.github.com/users/shawnbot/repos","events_url":"https://api.github.com/users/shawnbot/events{/privacy}","received_events_url":"https://api.github.com/users/shawnbot/received_events","type":"User","site_admin":false},"body":"This _very_ work-in-progress PR restructures the front end guide as a single-page document per #96. \r\nHere are the highlights:\r\n\r\n* I've temporarily switched to a bare (style-free) layout rather than using the 18F guides style, just so we can see how things are working.\r\n* I've whittled `_config.yml` down to its bare bones and removed all of the 18F guides style-specific stuff, including the `navigation` list.\r\n* I've tried to make it so that we can keep as much of our content in Markdown as possible, so that it's easier to write and maintain. This means that we can write fenced code blocks rather than HTML, and focus on writing rather than structuring markup.\r\n\r\n#### Site Structure\r\nThe new structure lives in [_data/chapters.yml](https://github.com/18F/frontend/blob/restructure/_data/chapters.yml), and is a nested list that describes the structure of the site, similarly to the 18F guides style [`navigation` list](https://github.com/18F/frontend/blob/18f-pages-staging/_config.yml#L28-L30). Moving this to `_data` allows us to modify it and see changes live(ish), whereas having it in `_config.yml` required restarting the server because Jekyll doesn't reload the config when it changes.\r\n\r\nThe `id` of each node in the chapters structure has an `id` key that corresponds to an include (i.e. `_includes/{{ id }}.md`; you can also specify a node's `file` key if you want to use a different `id`), which allows this structure to drive both the navigation (see [_includes/loop-nav.html](https://github.com/18F/frontend/blob/restructure/_includes/loop-nav.html)) and the document content (see [_includes/loop-content.html](https://github.com/18F/frontend/blob/restructure/_includes/loop-content.html)). In the new structure, all of the content lives in the [_includes directory](https://github.com/18F/frontend/tree/restructure/_includes), and can be organized there by section, as I've done with [some of the existing CSS content](https://github.com/18F/frontend/tree/restructure/_includes/css).\r\n\r\nMy next step was going to be to bring in the Draft Web Design Standards and maybe something like [ScrollSpy](http://getbootstrap.com/javascript/#scrollspy) to highlight active navigation. Alternatively, it might be nice to have the section titles use [position: sticky](http://www.sitepoint.com/css-position-sticky-introduction-polyfills/) so you can see where you are in the document.\r\n\r\n@andrewmaier I hear you might be interested in this because you're revamping 18F guides more generally. If so, we should probably coordinate!\r\n\r\nAnyone else have any thoughts on this approach? @maya @jeremiak @meiqimichelle @mbland @msecret @noahmanger @xtine @fureigh?","created_at":"2016-02-06T00:08:51Z","updated_at":"2016-02-08T18:48:06Z","closed_at":null,"merged_at":null,"merge_commit_sha":"24e367a8de7be2d108cc4ffc36e96b5d965b607a","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/18F/frontend/pulls/97/commits","review_comments_url":"https://api.github.com/repos/18F/frontend/pulls/97/comments","review_comment_url":"https://api.github.com/repos/18F/frontend/pulls/comments{/number}","comments_url":"https://api.github.com/repos/18F/frontend/issues/97/comments","statuses_url":"https://api.github.com/repos/18F/frontend/statuses/e584341d10d6aaf18664a5d29fb9e5f21a9844ba","head":{"label":"18F:restructure","ref":"restructure","sha":"e584341d10d6aaf18664a5d29fb9e5f21a9844ba","user":{"login":"18F","id":6233994,"avatar_url":"https://avatars.githubusercontent.com/u/6233994?v=3","gravatar_id":"","url":"https://api.github.com/users/18F","html_url":"https://github.com/18F","followers_url":"https://api.github.com/users/18F/followers","following_url":"https://api.github.com/users/18F/following{/other_user}","gists_url":"https://api.github.com/users/18F/gists{/gist_id}","starred_url":"https://api.github.com/users/18F/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/18F/subscriptions","organizations_url":"https://api.github.com/users/18F/orgs","repos_url":"https://api.github.com/users/18F/repos","events_url":"https://api.github.com/users/18F/events{/privacy}","received_events_url":"https://api.github.com/users/18F/received_events","type":"Organization","site_admin":false},"repo":{"id":24612990,"name":"frontend","full_name":"18F/frontend","owner":{"login":"18F","id":6233994,"avatar_url":"https://avatars.githubusercontent.com/u/6233994?v=3","gravatar_id":"","url":"https://api.github.com/users/18F","html_url":"https://github.com/18F","followers_url":"https://api.github.com/users/18F/followers","following_url":"https://api.github.com/users/18F/following{/other_user}","gists_url":"https://api.github.com/users/18F/gists{/gist_id}","starred_url":"https://api.github.com/users/18F/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/18F/subscriptions","organizations_url":"https://api.github.com/users/18F/orgs","repos_url":"https://api.github.com/users/18F/repos","events_url":"https://api.github.com/users/18F/events{/privacy}","received_events_url":"https://api.github.com/users/18F/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/18F/frontend","description":"18F's Front End Guild","fork":false,"url":"https://api.github.com/repos/18F/frontend","forks_url":"https://api.github.com/repos/18F/frontend/forks","keys_url":"https://api.github.com/repos/18F/frontend/keys{/key_id}","collaborators_url":"https://api.github.com/repos/18F/frontend/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/18F/frontend/teams","hooks_url":"https://api.github.com/repos/18F/frontend/hooks","issue_events_url":"https://api.github.com/repos/18F/frontend/issues/events{/number}","events_url":"https://api.github.com/repos/18F/frontend/events","assignees_url":"https://api.github.com/repos/18F/frontend/assignees{/user}","branches_url":"https://api.github.com/repos/18F/frontend/branches{/branch}","tags_url":"https://api.github.com/repos/18F/frontend/tags","blobs_url":"https://api.github.com/repos/18F/frontend/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/18F/frontend/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/18F/frontend/git/refs{/sha}","trees_url":"https://api.github.com/repos/18F/frontend/git/trees{/sha}","statuses_url":"https://api.github.com/repos/18F/frontend/statuses/{sha}","languages_url":"https://api.github.com/repos/18F/frontend/languages","stargazers_url":"https://api.github.com/repos/18F/frontend/stargazers","contributors_url":"https://api.github.com/repos/18F/frontend/contributors","subscribers_url":"https://api.github.com/repos/18F/frontend/subscribers","subscription_url":"https://api.github.com/repos/18F/frontend/subscription","commits_url":"https://api.github.com/repos/18F/frontend/commits{/sha}","git_commits_url":"https://api.github.com/repos/18F/frontend/git/commits{/sha}","comments_url":"https://api.github.com/repos/18F/frontend/comments{/number}","issue_comment_url":"https://api.github.com/repos/18F/frontend/issues/comments{/number}","contents_url":"https://api.github.com/repos/18F/frontend/contents/{+path}","compare_url":"https://api.github.com/repos/18F/frontend/compare/{base}...{head}","merges_url":"https://api.github.com/repos/18F/frontend/merges","archive_url":"https://api.github.com/repos/18F/frontend/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/18F/frontend/downloads","issues_url":"https://api.github.com/repos/18F/frontend/issues{/number}","pulls_url":"https://api.github.com/repos/18F/frontend/pulls{/number}","milestones_url":"https://api.github.com/repos/18F/frontend/milestones{/number}","notifications_url":"https://api.github.com/repos/18F/frontend/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/18F/frontend/labels{/name}","releases_url":"https://api.github.com/repos/18F/frontend/releases{/id}","deployments_url":"https://api.github.com/repos/18F/frontend/deployments","created_at":"2014-09-29T21:04:18Z","updated_at":"2016-02-04T15:27:58Z","pushed_at":"2016-02-06T00:08:51Z","git_url":"git://github.com/18F/frontend.git","ssh_url":"git@github.com:18F/frontend.git","clone_url":"https://github.com/18F/frontend.git","svn_url":"https://github.com/18F/frontend","homepage":"https://pages.18f.gov/frontend/","size":652,"stargazers_count":89,"watchers_count":89,"language":"Ruby","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":21,"mirror_url":null,"open_issues_count":40,"forks":21,"open_issues":40,"watchers":89,"default_branch":"18f-pages-staging"}},"base":{"label":"18F:18f-pages-staging","ref":"18f-pages-staging","sha":"e84122c281f258f1cf8d9127662c77bc43e884a8","user":{"login":"18F","id":6233994,"avatar_url":"https://avatars.githubusercontent.com/u/6233994?v=3","gravatar_id":"","url":"https://api.github.com/users/18F","html_url":"https://github.com/18F","followers_url":"https://api.github.com/users/18F/followers","following_url":"https://api.github.com/users/18F/following{/other_user}","gists_url":"https://api.github.com/users/18F/gists{/gist_id}","starred_url":"https://api.github.com/users/18F/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/18F/subscriptions","organizations_url":"https://api.github.com/users/18F/orgs","repos_url":"https://api.github.com/users/18F/repos","events_url":"https://api.github.com/users/18F/events{/privacy}","received_events_url":"https://api.github.com/users/18F/received_events","type":"Organization","site_admin":false},"repo":{"id":24612990,"name":"frontend","full_name":"18F/frontend","owner":{"login":"18F","id":6233994,"avatar_url":"https://avatars.githubusercontent.com/u/6233994?v=3","gravatar_id":"","url":"https://api.github.com/users/18F","html_url":"https://github.com/18F","followers_url":"https://api.github.com/users/18F/followers","following_url":"https://api.github.com/users/18F/following{/other_user}","gists_url":"https://api.github.com/users/18F/gists{/gist_id}","starred_url":"https://api.github.com/users/18F/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/18F/subscriptions","organizations_url":"https://api.github.com/users/18F/orgs","repos_url":"https://api.github.com/users/18F/repos","events_url":"https://api.github.com/users/18F/events{/privacy}","received_events_url":"https://api.github.com/users/18F/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/18F/frontend","description":"18F's Front End Guild","fork":false,"url":"https://api.github.com/repos/18F/frontend","forks_url":"https://api.github.com/repos/18F/frontend/forks","keys_url":"https://api.github.com/repos/18F/frontend/keys{/key_id}","collaborators_url":"https://api.github.com/repos/18F/frontend/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/18F/frontend/teams","hooks_url":"https://api.github.com/repos/18F/frontend/hooks","issue_events_url":"https://api.github.com/repos/18F/frontend/issues/events{/number}","events_url":"https://api.github.com/repos/18F/frontend/events","assignees_url":"https://api.github.com/repos/18F/frontend/assignees{/user}","branches_url":"https://api.github.com/repos/18F/frontend/branches{/branch}","tags_url":"https://api.github.com/repos/18F/frontend/tags","blobs_url":"https://api.github.com/repos/18F/frontend/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/18F/frontend/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/18F/frontend/git/refs{/sha}","trees_url":"https://api.github.com/repos/18F/frontend/git/trees{/sha}","statuses_url":"https://api.github.com/repos/18F/frontend/statuses/{sha}","languages_url":"https://api.github.com/repos/18F/frontend/languages","stargazers_url":"https://api.github.com/repos/18F/frontend/stargazers","contributors_url":"https://api.github.com/repos/18F/frontend/contributors","subscribers_url":"https://api.github.com/repos/18F/frontend/subscribers","subscription_url":"https://api.github.com/repos/18F/frontend/subscription","commits_url":"https://api.github.com/repos/18F/frontend/commits{/sha}","git_commits_url":"https://api.github.com/repos/18F/frontend/git/commits{/sha}","comments_url":"https://api.github.com/repos/18F/frontend/comments{/number}","issue_comment_url":"https://api.github.com/repos/18F/frontend/issues/comments{/number}","contents_url":"https://api.github.com/repos/18F/frontend/contents/{+path}","compare_url":"https://api.github.com/repos/18F/frontend/compare/{base}...{head}","merges_url":"https://api.github.com/repos/18F/frontend/merges","archive_url":"https://api.github.com/repos/18F/frontend/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/18F/frontend/downloads","issues_url":"https://api.github.com/repos/18F/frontend/issues{/number}","pulls_url":"https://api.github.com/repos/18F/frontend/pulls{/number}","milestones_url":"https://api.github.com/repos/18F/frontend/milestones{/number}","notifications_url":"https://api.github.com/repos/18F/frontend/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/18F/frontend/labels{/name}","releases_url":"https://api.github.com/repos/18F/frontend/releases{/id}","deployments_url":"https://api.github.com/repos/18F/frontend/deployments","created_at":"2014-09-29T21:04:18Z","updated_at":"2016-02-04T15:27:58Z","pushed_at":"2016-02-06T00:08:51Z","git_url":"git://github.com/18F/frontend.git","ssh_url":"git@github.com:18F/frontend.git","clone_url":"https://github.com/18F/frontend.git","svn_url":"https://github.com/18F/frontend","homepage":"https://pages.18f.gov/frontend/","size":652,"stargazers_count":89,"watchers_count":89,"language":"Ruby","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":21,"mirror_url":null,"open_issues_count":40,"forks":21,"open_issues":40,"watchers":89,"default_branch":"18f-pages-staging"}},"_links":{"self":{"href":"https://api.github.com/repos/18F/frontend/pulls/97"},"html":{"href":"https://github.com/18F/frontend/pull/97"},"issue":{"href":"https://api.github.com/repos/18F/frontend/issues/97"},"comments":{"href":"https://api.github.com/repos/18F/frontend/issues/97/comments"},"review_comments":{"href":"https://api.github.com/repos/18F/frontend/pulls/97/comments"},"review_comment":{"href":"https://api.github.com/repos/18F/frontend/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/18F/frontend/pulls/97/commits"},"statuses":{"href":"https://api.github.com/repos/18F/frontend/statuses/e584341d10d6aaf18664a5d29fb9e5f21a9844ba"}}}}