{"action":"created","comment":{"url":"https://api.github.com/repos/mojotech/dill/pulls/comments/34661095","id":34661095,"diff_hunk":"@@ -131,15 +141,364 @@ class Admin < Dill::Role\n end\n ```\n \n-##To Be Continued...\n+That's it for the walkthrough, but Dill has a lot more to offer. We recommend digging into Widgets next, as Widget is the fundamental class common to all the Dill elements.\n+\n+\n+#Widgets<a name=\"widgets\"></a>\n+A widget is the fundamental Dill element. A widget wraps a DOM element, allowing you to call methods on that element, like checking for text or clicking.\n+\n+\n+## Widget Declaration\n+A widget can be declared with the `widget` macro, or as a class. We prefer the macro declaration where possible.\n+\n+Maco widget declarations take a CSS selector as the first argument.\n+\n+```ruby\n+  widget :todo_item, '.todo-item'\n+```\n+\n+Class widget declarations define the widget with CSS selectors via the `root` macro.\n+\n+```ruby\n+class TodoItem < Dill::Widget\n+  root '.todo-item'\n+end\n+```\n+\n+## Nested Widgets\n+Widgets can be defined within widgets. CSS classes of child widgets are scoped within the class of the parent widget.\n+\n+Child widgets are available via the `widget` method.\n+\n+```ruby\n+class TodoManager < Dill::Role\n+  widget :todo_item, '.todo-item' do\n+    widget :delete_link, '.delete' # :delete_link looks for a .delete class within a .todo-item element\n+  end\n+\n+  # to access the delete_link widget:\n+  # widget(:todo_item).widget(:delete_link)","path":"README.md","position":74,"original_position":74,"commit_id":"bea9ec0c405bf46b0ee89c7efb04a4c9ae77058e","original_commit_id":"bea9ec0c405bf46b0ee89c7efb04a4c9ae77058e","user":{"login":"david","id":293,"avatar_url":"https://avatars.githubusercontent.com/u/293?v=3","gravatar_id":"","url":"https://api.github.com/users/david","html_url":"https://github.com/david","followers_url":"https://api.github.com/users/david/followers","following_url":"https://api.github.com/users/david/following{/other_user}","gists_url":"https://api.github.com/users/david/gists{/gist_id}","starred_url":"https://api.github.com/users/david/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/david/subscriptions","organizations_url":"https://api.github.com/users/david/orgs","repos_url":"https://api.github.com/users/david/repos","events_url":"https://api.github.com/users/david/events{/privacy}","received_events_url":"https://api.github.com/users/david/received_events","type":"User","site_admin":false},"body":"But don't do this. :)","created_at":"2015-07-15T09:30:24Z","updated_at":"2015-07-15T09:30:24Z","html_url":"https://github.com/mojotech/dill/pull/101#discussion_r34661095","pull_request_url":"https://api.github.com/repos/mojotech/dill/pulls/101","_links":{"self":{"href":"https://api.github.com/repos/mojotech/dill/pulls/comments/34661095"},"html":{"href":"https://github.com/mojotech/dill/pull/101#discussion_r34661095"},"pull_request":{"href":"https://api.github.com/repos/mojotech/dill/pulls/101"}}},"pull_request":{"url":"https://api.github.com/repos/mojotech/dill/pulls/101","id":39728480,"html_url":"https://github.com/mojotech/dill/pull/101","diff_url":"https://github.com/mojotech/dill/pull/101.diff","patch_url":"https://github.com/mojotech/dill/pull/101.patch","issue_url":"https://api.github.com/repos/mojotech/dill/issues/101","number":101,"state":"open","locked":false,"title":"Update Docs with Major Widget Descriptions","user":{"login":"adsteel","id":4186462,"avatar_url":"https://avatars.githubusercontent.com/u/4186462?v=3","gravatar_id":"","url":"https://api.github.com/users/adsteel","html_url":"https://github.com/adsteel","followers_url":"https://api.github.com/users/adsteel/followers","following_url":"https://api.github.com/users/adsteel/following{/other_user}","gists_url":"https://api.github.com/users/adsteel/gists{/gist_id}","starred_url":"https://api.github.com/users/adsteel/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/adsteel/subscriptions","organizations_url":"https://api.github.com/users/adsteel/orgs","repos_url":"https://api.github.com/users/adsteel/repos","events_url":"https://api.github.com/users/adsteel/events{/privacy}","received_events_url":"https://api.github.com/users/adsteel/received_events","type":"User","site_admin":false},"body":"","created_at":"2015-07-10T21:59:05Z","updated_at":"2015-07-15T09:30:24Z","closed_at":null,"merged_at":null,"merge_commit_sha":"1c683a8b0a4bc88491eb05dcf51d0c055601a379","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/mojotech/dill/pulls/101/commits","review_comments_url":"https://api.github.com/repos/mojotech/dill/pulls/101/comments","review_comment_url":"https://api.github.com/repos/mojotech/dill/pulls/comments{/number}","comments_url":"https://api.github.com/repos/mojotech/dill/issues/101/comments","statuses_url":"https://api.github.com/repos/mojotech/dill/statuses/bea9ec0c405bf46b0ee89c7efb04a4c9ae77058e","head":{"label":"adsteel:ags/update-docs","ref":"ags/update-docs","sha":"bea9ec0c405bf46b0ee89c7efb04a4c9ae77058e","user":{"login":"adsteel","id":4186462,"avatar_url":"https://avatars.githubusercontent.com/u/4186462?v=3","gravatar_id":"","url":"https://api.github.com/users/adsteel","html_url":"https://github.com/adsteel","followers_url":"https://api.github.com/users/adsteel/followers","following_url":"https://api.github.com/users/adsteel/following{/other_user}","gists_url":"https://api.github.com/users/adsteel/gists{/gist_id}","starred_url":"https://api.github.com/users/adsteel/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/adsteel/subscriptions","organizations_url":"https://api.github.com/users/adsteel/orgs","repos_url":"https://api.github.com/users/adsteel/repos","events_url":"https://api.github.com/users/adsteel/events{/privacy}","received_events_url":"https://api.github.com/users/adsteel/received_events","type":"User","site_admin":false},"repo":{"id":36958392,"name":"dill","full_name":"adsteel/dill","owner":{"login":"adsteel","id":4186462,"avatar_url":"https://avatars.githubusercontent.com/u/4186462?v=3","gravatar_id":"","url":"https://api.github.com/users/adsteel","html_url":"https://github.com/adsteel","followers_url":"https://api.github.com/users/adsteel/followers","following_url":"https://api.github.com/users/adsteel/following{/other_user}","gists_url":"https://api.github.com/users/adsteel/gists{/gist_id}","starred_url":"https://api.github.com/users/adsteel/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/adsteel/subscriptions","organizations_url":"https://api.github.com/users/adsteel/orgs","repos_url":"https://api.github.com/users/adsteel/repos","events_url":"https://api.github.com/users/adsteel/events{/privacy}","received_events_url":"https://api.github.com/users/adsteel/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/adsteel/dill","description":"Chop up all the cucumbers into a fresh delicious salad.","fork":true,"url":"https://api.github.com/repos/adsteel/dill","forks_url":"https://api.github.com/repos/adsteel/dill/forks","keys_url":"https://api.github.com/repos/adsteel/dill/keys{/key_id}","collaborators_url":"https://api.github.com/repos/adsteel/dill/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/adsteel/dill/teams","hooks_url":"https://api.github.com/repos/adsteel/dill/hooks","issue_events_url":"https://api.github.com/repos/adsteel/dill/issues/events{/number}","events_url":"https://api.github.com/repos/adsteel/dill/events","assignees_url":"https://api.github.com/repos/adsteel/dill/assignees{/user}","branches_url":"https://api.github.com/repos/adsteel/dill/branches{/branch}","tags_url":"https://api.github.com/repos/adsteel/dill/tags","blobs_url":"https://api.github.com/repos/adsteel/dill/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/adsteel/dill/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/adsteel/dill/git/refs{/sha}","trees_url":"https://api.github.com/repos/adsteel/dill/git/trees{/sha}","statuses_url":"https://api.github.com/repos/adsteel/dill/statuses/{sha}","languages_url":"https://api.github.com/repos/adsteel/dill/languages","stargazers_url":"https://api.github.com/repos/adsteel/dill/stargazers","contributors_url":"https://api.github.com/repos/adsteel/dill/contributors","subscribers_url":"https://api.github.com/repos/adsteel/dill/subscribers","subscription_url":"https://api.github.com/repos/adsteel/dill/subscription","commits_url":"https://api.github.com/repos/adsteel/dill/commits{/sha}","git_commits_url":"https://api.github.com/repos/adsteel/dill/git/commits{/sha}","comments_url":"https://api.github.com/repos/adsteel/dill/comments{/number}","issue_comment_url":"https://api.github.com/repos/adsteel/dill/issues/comments{/number}","contents_url":"https://api.github.com/repos/adsteel/dill/contents/{+path}","compare_url":"https://api.github.com/repos/adsteel/dill/compare/{base}...{head}","merges_url":"https://api.github.com/repos/adsteel/dill/merges","archive_url":"https://api.github.com/repos/adsteel/dill/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/adsteel/dill/downloads","issues_url":"https://api.github.com/repos/adsteel/dill/issues{/number}","pulls_url":"https://api.github.com/repos/adsteel/dill/pulls{/number}","milestones_url":"https://api.github.com/repos/adsteel/dill/milestones{/number}","notifications_url":"https://api.github.com/repos/adsteel/dill/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/adsteel/dill/labels{/name}","releases_url":"https://api.github.com/repos/adsteel/dill/releases{/id}","created_at":"2015-06-05T22:24:31Z","updated_at":"2015-06-05T22:24:31Z","pushed_at":"2015-07-11T03:57:21Z","git_url":"git://github.com/adsteel/dill.git","ssh_url":"git@github.com:adsteel/dill.git","clone_url":"https://github.com/adsteel/dill.git","svn_url":"https://github.com/adsteel/dill","homepage":null,"size":671,"stargazers_count":0,"watchers_count":0,"language":"Ruby","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":"mojotech:master","ref":"master","sha":"4f8160efc51222e4c7b918e57eff428b553de53e","user":{"login":"mojotech","id":314035,"avatar_url":"https://avatars.githubusercontent.com/u/314035?v=3","gravatar_id":"","url":"https://api.github.com/users/mojotech","html_url":"https://github.com/mojotech","followers_url":"https://api.github.com/users/mojotech/followers","following_url":"https://api.github.com/users/mojotech/following{/other_user}","gists_url":"https://api.github.com/users/mojotech/gists{/gist_id}","starred_url":"https://api.github.com/users/mojotech/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mojotech/subscriptions","organizations_url":"https://api.github.com/users/mojotech/orgs","repos_url":"https://api.github.com/users/mojotech/repos","events_url":"https://api.github.com/users/mojotech/events{/privacy}","received_events_url":"https://api.github.com/users/mojotech/received_events","type":"Organization","site_admin":false},"repo":{"id":9579367,"name":"dill","full_name":"mojotech/dill","owner":{"login":"mojotech","id":314035,"avatar_url":"https://avatars.githubusercontent.com/u/314035?v=3","gravatar_id":"","url":"https://api.github.com/users/mojotech","html_url":"https://github.com/mojotech","followers_url":"https://api.github.com/users/mojotech/followers","following_url":"https://api.github.com/users/mojotech/following{/other_user}","gists_url":"https://api.github.com/users/mojotech/gists{/gist_id}","starred_url":"https://api.github.com/users/mojotech/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mojotech/subscriptions","organizations_url":"https://api.github.com/users/mojotech/orgs","repos_url":"https://api.github.com/users/mojotech/repos","events_url":"https://api.github.com/users/mojotech/events{/privacy}","received_events_url":"https://api.github.com/users/mojotech/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/mojotech/dill","description":"Chop up all the cucumbers into a fresh delicious salad.","fork":false,"url":"https://api.github.com/repos/mojotech/dill","forks_url":"https://api.github.com/repos/mojotech/dill/forks","keys_url":"https://api.github.com/repos/mojotech/dill/keys{/key_id}","collaborators_url":"https://api.github.com/repos/mojotech/dill/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/mojotech/dill/teams","hooks_url":"https://api.github.com/repos/mojotech/dill/hooks","issue_events_url":"https://api.github.com/repos/mojotech/dill/issues/events{/number}","events_url":"https://api.github.com/repos/mojotech/dill/events","assignees_url":"https://api.github.com/repos/mojotech/dill/assignees{/user}","branches_url":"https://api.github.com/repos/mojotech/dill/branches{/branch}","tags_url":"https://api.github.com/repos/mojotech/dill/tags","blobs_url":"https://api.github.com/repos/mojotech/dill/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/mojotech/dill/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/mojotech/dill/git/refs{/sha}","trees_url":"https://api.github.com/repos/mojotech/dill/git/trees{/sha}","statuses_url":"https://api.github.com/repos/mojotech/dill/statuses/{sha}","languages_url":"https://api.github.com/repos/mojotech/dill/languages","stargazers_url":"https://api.github.com/repos/mojotech/dill/stargazers","contributors_url":"https://api.github.com/repos/mojotech/dill/contributors","subscribers_url":"https://api.github.com/repos/mojotech/dill/subscribers","subscription_url":"https://api.github.com/repos/mojotech/dill/subscription","commits_url":"https://api.github.com/repos/mojotech/dill/commits{/sha}","git_commits_url":"https://api.github.com/repos/mojotech/dill/git/commits{/sha}","comments_url":"https://api.github.com/repos/mojotech/dill/comments{/number}","issue_comment_url":"https://api.github.com/repos/mojotech/dill/issues/comments{/number}","contents_url":"https://api.github.com/repos/mojotech/dill/contents/{+path}","compare_url":"https://api.github.com/repos/mojotech/dill/compare/{base}...{head}","merges_url":"https://api.github.com/repos/mojotech/dill/merges","archive_url":"https://api.github.com/repos/mojotech/dill/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/mojotech/dill/downloads","issues_url":"https://api.github.com/repos/mojotech/dill/issues{/number}","pulls_url":"https://api.github.com/repos/mojotech/dill/pulls{/number}","milestones_url":"https://api.github.com/repos/mojotech/dill/milestones{/number}","notifications_url":"https://api.github.com/repos/mojotech/dill/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/mojotech/dill/labels{/name}","releases_url":"https://api.github.com/repos/mojotech/dill/releases{/id}","created_at":"2013-04-21T12:54:56Z","updated_at":"2015-03-24T17:44:46Z","pushed_at":"2015-07-11T03:57:22Z","git_url":"git://github.com/mojotech/dill.git","ssh_url":"git@github.com:mojotech/dill.git","clone_url":"https://github.com/mojotech/dill.git","svn_url":"https://github.com/mojotech/dill","homepage":null,"size":1981,"stargazers_count":8,"watchers_count":8,"language":"Ruby","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":2,"mirror_url":null,"open_issues_count":30,"forks":2,"open_issues":30,"watchers":8,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/mojotech/dill/pulls/101"},"html":{"href":"https://github.com/mojotech/dill/pull/101"},"issue":{"href":"https://api.github.com/repos/mojotech/dill/issues/101"},"comments":{"href":"https://api.github.com/repos/mojotech/dill/issues/101/comments"},"review_comments":{"href":"https://api.github.com/repos/mojotech/dill/pulls/101/comments"},"review_comment":{"href":"https://api.github.com/repos/mojotech/dill/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/mojotech/dill/pulls/101/commits"},"statuses":{"href":"https://api.github.com/repos/mojotech/dill/statuses/bea9ec0c405bf46b0ee89c7efb04a4c9ae77058e"}}}}