{"action":"created","comment":{"url":"https://api.github.com/repos/ipfs/docs/pulls/comments/343776977","pull_request_review_id":313508385,"id":343776977,"node_id":"MDI0OlB1bGxSZXF1ZXN0UmV2aWV3Q29tbWVudDM0Mzc3Njk3Nw==","diff_hunk":"@@ -7,70 +7,57 @@ menu:\n \n **NOTE: The info below is a quick guide to DNSLink. For a more complete guide, including tutorials, usage examples and FAQs, check out [dnslink.io](http://dnslink.io/).**\n \n-## About DNSLink\n+## What is DNSLink?\n \n-DNSLink uses [DNS TXT](https://en.wikipedia.org/wiki/TXT_record) records to map\n-a domain name (like `ipfs.io`) to an IPFS address. Because you can edit your\n-DNS records, you can use them to always point to the latest version of an\n-object in IPFS (remember that an IPFS object’s address changes if you modify\n-the object). Because DNSLink uses DNS records, the names it produces are also\n-usually easy to type and read.\n+DNSLink uses [DNS TXT](https://en.wikipedia.org/wiki/TXT_record) records to map a domain name (like `ipfs.io`) to an IPFS address. Because you can edit your DNS records, you can use them to always point to the latest version of an object in IPFS (remember that an IPFS object’s address changes if you modify the object). Because DNSLink uses DNS records, the names it produces are also usually easy to type and read.\n \n-A DNSLink address looks like an [IPNS](/guides/concepts/ipns) address, but it\n-uses a domain name in place of a hashed public key:\n+A DNSLink address looks like an [IPNS](/guides/concepts/ipns) address, but it uses a domain name in place of a hashed public key:\n \n ```\n-/ipns/ipfs.io\n+/ipns/myexampledomain.org\n ```\n \n Just like normal IPFS addresses, they can include links to other files:\n \n ```\n-/ipns/ipfs.io/media/\n+/ipns/myexampledomain.org/media/\n ```\n \n-When an IPFS client or node attempts to resolve that address, it looks for a `TXT` record for `ipfs.io` with content like:\n+### Publishing using a subdomain\n+\n+While you can publish the TXT record to the exact domain (as in the example above) if you so wish, it can be more advantageous to publish DNSLink records using a special subdomain called `_dnslink`. This enables you to improve the security of an automated setup, or delegate control over your DNSLink records to a third party without giving away full control over the original DNS zone.","path":"content/guides/concepts/dnslink.md","position":null,"original_position":34,"commit_id":"46b51e352aa537059fc9b9f0cdacaea5e52f0a22","original_commit_id":"d00dd08fbc25ea8abac2f74f112ee980f1801cc4","user":{"login":"jessicaschilling","id":1507828,"node_id":"MDQ6VXNlcjE1MDc4Mjg=","avatar_url":"https://avatars3.githubusercontent.com/u/1507828?v=4","gravatar_id":"","url":"https://api.github.com/users/jessicaschilling","html_url":"https://github.com/jessicaschilling","followers_url":"https://api.github.com/users/jessicaschilling/followers","following_url":"https://api.github.com/users/jessicaschilling/following{/other_user}","gists_url":"https://api.github.com/users/jessicaschilling/gists{/gist_id}","starred_url":"https://api.github.com/users/jessicaschilling/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jessicaschilling/subscriptions","organizations_url":"https://api.github.com/users/jessicaschilling/orgs","repos_url":"https://api.github.com/users/jessicaschilling/repos","events_url":"https://api.github.com/users/jessicaschilling/events{/privacy}","received_events_url":"https://api.github.com/users/jessicaschilling/received_events","type":"User","site_admin":false},"body":"Thanks for catching that!","created_at":"2019-11-07T17:26:21Z","updated_at":"2019-11-07T17:26:21Z","html_url":"https://github.com/ipfs/docs/pull/369#discussion_r343776977","pull_request_url":"https://api.github.com/repos/ipfs/docs/pulls/369","author_association":"COLLABORATOR","_links":{"self":{"href":"https://api.github.com/repos/ipfs/docs/pulls/comments/343776977"},"html":{"href":"https://github.com/ipfs/docs/pull/369#discussion_r343776977"},"pull_request":{"href":"https://api.github.com/repos/ipfs/docs/pulls/369"}},"in_reply_to_id":343503525},"pull_request":{"url":"https://api.github.com/repos/ipfs/docs/pulls/369","id":337527391,"node_id":"MDExOlB1bGxSZXF1ZXN0MzM3NTI3Mzkx","html_url":"https://github.com/ipfs/docs/pull/369","diff_url":"https://github.com/ipfs/docs/pull/369.diff","patch_url":"https://github.com/ipfs/docs/pull/369.patch","issue_url":"https://api.github.com/repos/ipfs/docs/issues/369","number":369,"state":"open","locked":false,"title":"Update dnslink.md","user":{"login":"jessicaschilling","id":1507828,"node_id":"MDQ6VXNlcjE1MDc4Mjg=","avatar_url":"https://avatars3.githubusercontent.com/u/1507828?v=4","gravatar_id":"","url":"https://api.github.com/users/jessicaschilling","html_url":"https://github.com/jessicaschilling","followers_url":"https://api.github.com/users/jessicaschilling/followers","following_url":"https://api.github.com/users/jessicaschilling/following{/other_user}","gists_url":"https://api.github.com/users/jessicaschilling/gists{/gist_id}","starred_url":"https://api.github.com/users/jessicaschilling/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jessicaschilling/subscriptions","organizations_url":"https://api.github.com/users/jessicaschilling/orgs","repos_url":"https://api.github.com/users/jessicaschilling/repos","events_url":"https://api.github.com/users/jessicaschilling/events{/privacy}","received_events_url":"https://api.github.com/users/jessicaschilling/received_events","type":"User","site_admin":false},"body":"Restructuring comment per @olizilla's notes in https://github.com/ipfs/docs/issues/365#issuecomment-550350653","created_at":"2019-11-06T19:07:10Z","updated_at":"2019-11-07T17:26:21Z","closed_at":null,"merged_at":null,"merge_commit_sha":"98e5add6214d309ebb2c45f841c4e0954fa921de","assignee":{"login":"jessicaschilling","id":1507828,"node_id":"MDQ6VXNlcjE1MDc4Mjg=","avatar_url":"https://avatars3.githubusercontent.com/u/1507828?v=4","gravatar_id":"","url":"https://api.github.com/users/jessicaschilling","html_url":"https://github.com/jessicaschilling","followers_url":"https://api.github.com/users/jessicaschilling/followers","following_url":"https://api.github.com/users/jessicaschilling/following{/other_user}","gists_url":"https://api.github.com/users/jessicaschilling/gists{/gist_id}","starred_url":"https://api.github.com/users/jessicaschilling/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jessicaschilling/subscriptions","organizations_url":"https://api.github.com/users/jessicaschilling/orgs","repos_url":"https://api.github.com/users/jessicaschilling/repos","events_url":"https://api.github.com/users/jessicaschilling/events{/privacy}","received_events_url":"https://api.github.com/users/jessicaschilling/received_events","type":"User","site_admin":false},"assignees":[{"login":"jessicaschilling","id":1507828,"node_id":"MDQ6VXNlcjE1MDc4Mjg=","avatar_url":"https://avatars3.githubusercontent.com/u/1507828?v=4","gravatar_id":"","url":"https://api.github.com/users/jessicaschilling","html_url":"https://github.com/jessicaschilling","followers_url":"https://api.github.com/users/jessicaschilling/followers","following_url":"https://api.github.com/users/jessicaschilling/following{/other_user}","gists_url":"https://api.github.com/users/jessicaschilling/gists{/gist_id}","starred_url":"https://api.github.com/users/jessicaschilling/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jessicaschilling/subscriptions","organizations_url":"https://api.github.com/users/jessicaschilling/orgs","repos_url":"https://api.github.com/users/jessicaschilling/repos","events_url":"https://api.github.com/users/jessicaschilling/events{/privacy}","received_events_url":"https://api.github.com/users/jessicaschilling/received_events","type":"User","site_admin":false}],"requested_reviewers":[{"login":"olizilla","id":58871,"node_id":"MDQ6VXNlcjU4ODcx","avatar_url":"https://avatars3.githubusercontent.com/u/58871?v=4","gravatar_id":"","url":"https://api.github.com/users/olizilla","html_url":"https://github.com/olizilla","followers_url":"https://api.github.com/users/olizilla/followers","following_url":"https://api.github.com/users/olizilla/following{/other_user}","gists_url":"https://api.github.com/users/olizilla/gists{/gist_id}","starred_url":"https://api.github.com/users/olizilla/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/olizilla/subscriptions","organizations_url":"https://api.github.com/users/olizilla/orgs","repos_url":"https://api.github.com/users/olizilla/repos","events_url":"https://api.github.com/users/olizilla/events{/privacy}","received_events_url":"https://api.github.com/users/olizilla/received_events","type":"User","site_admin":false}],"requested_teams":[],"labels":[{"id":1566224742,"node_id":"MDU6TGFiZWwxNTY2MjI0NzQy","url":"https://api.github.com/repos/ipfs/docs/labels/OKR%203:%20Content%20Improvement","name":"OKR 3: Content Improvement","color":"c8c4f5","default":false},{"id":1566213446,"node_id":"MDU6TGFiZWwxNTY2MjEzNDQ2","url":"https://api.github.com/repos/ipfs/docs/labels/Size:%20S","name":"Size: S","color":"75c8ef","default":false},{"id":1391251959,"node_id":"MDU6TGFiZWwxMzkxMjUxOTU5","url":"https://api.github.com/repos/ipfs/docs/labels/design-content","name":"design-content","color":"3f4b56","default":false},{"id":717960172,"node_id":"MDU6TGFiZWw3MTc5NjAxNzI=","url":"https://api.github.com/repos/ipfs/docs/labels/difficulty:easy","name":"difficulty:easy","color":"bfe5bf","default":false}],"milestone":null,"commits_url":"https://api.github.com/repos/ipfs/docs/pulls/369/commits","review_comments_url":"https://api.github.com/repos/ipfs/docs/pulls/369/comments","review_comment_url":"https://api.github.com/repos/ipfs/docs/pulls/comments{/number}","comments_url":"https://api.github.com/repos/ipfs/docs/issues/369/comments","statuses_url":"https://api.github.com/repos/ipfs/docs/statuses/46b51e352aa537059fc9b9f0cdacaea5e52f0a22","head":{"label":"ipfs:bug-dnslink-examples","ref":"bug-dnslink-examples","sha":"46b51e352aa537059fc9b9f0cdacaea5e52f0a22","user":{"login":"ipfs","id":10536621,"node_id":"MDEyOk9yZ2FuaXphdGlvbjEwNTM2NjIx","avatar_url":"https://avatars0.githubusercontent.com/u/10536621?v=4","gravatar_id":"","url":"https://api.github.com/users/ipfs","html_url":"https://github.com/ipfs","followers_url":"https://api.github.com/users/ipfs/followers","following_url":"https://api.github.com/users/ipfs/following{/other_user}","gists_url":"https://api.github.com/users/ipfs/gists{/gist_id}","starred_url":"https://api.github.com/users/ipfs/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ipfs/subscriptions","organizations_url":"https://api.github.com/users/ipfs/orgs","repos_url":"https://api.github.com/users/ipfs/repos","events_url":"https://api.github.com/users/ipfs/events{/privacy}","received_events_url":"https://api.github.com/users/ipfs/received_events","type":"Organization","site_admin":false},"repo":{"id":83828178,"node_id":"MDEwOlJlcG9zaXRvcnk4MzgyODE3OA==","name":"docs","full_name":"ipfs/docs","private":false,"owner":{"login":"ipfs","id":10536621,"node_id":"MDEyOk9yZ2FuaXphdGlvbjEwNTM2NjIx","avatar_url":"https://avatars0.githubusercontent.com/u/10536621?v=4","gravatar_id":"","url":"https://api.github.com/users/ipfs","html_url":"https://github.com/ipfs","followers_url":"https://api.github.com/users/ipfs/followers","following_url":"https://api.github.com/users/ipfs/following{/other_user}","gists_url":"https://api.github.com/users/ipfs/gists{/gist_id}","starred_url":"https://api.github.com/users/ipfs/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ipfs/subscriptions","organizations_url":"https://api.github.com/users/ipfs/orgs","repos_url":"https://api.github.com/users/ipfs/repos","events_url":"https://api.github.com/users/ipfs/events{/privacy}","received_events_url":"https://api.github.com/users/ipfs/received_events","type":"Organization","site_admin":false},"html_url":"https://github.com/ipfs/docs","description":"🤖 📚 Documentation website for the IPFS project.","fork":false,"url":"https://api.github.com/repos/ipfs/docs","forks_url":"https://api.github.com/repos/ipfs/docs/forks","keys_url":"https://api.github.com/repos/ipfs/docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/ipfs/docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/ipfs/docs/teams","hooks_url":"https://api.github.com/repos/ipfs/docs/hooks","issue_events_url":"https://api.github.com/repos/ipfs/docs/issues/events{/number}","events_url":"https://api.github.com/repos/ipfs/docs/events","assignees_url":"https://api.github.com/repos/ipfs/docs/assignees{/user}","branches_url":"https://api.github.com/repos/ipfs/docs/branches{/branch}","tags_url":"https://api.github.com/repos/ipfs/docs/tags","blobs_url":"https://api.github.com/repos/ipfs/docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/ipfs/docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/ipfs/docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/ipfs/docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/ipfs/docs/statuses/{sha}","languages_url":"https://api.github.com/repos/ipfs/docs/languages","stargazers_url":"https://api.github.com/repos/ipfs/docs/stargazers","contributors_url":"https://api.github.com/repos/ipfs/docs/contributors","subscribers_url":"https://api.github.com/repos/ipfs/docs/subscribers","subscription_url":"https://api.github.com/repos/ipfs/docs/subscription","commits_url":"https://api.github.com/repos/ipfs/docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/ipfs/docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/ipfs/docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/ipfs/docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/ipfs/docs/contents/{+path}","compare_url":"https://api.github.com/repos/ipfs/docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/ipfs/docs/merges","archive_url":"https://api.github.com/repos/ipfs/docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/ipfs/docs/downloads","issues_url":"https://api.github.com/repos/ipfs/docs/issues{/number}","pulls_url":"https://api.github.com/repos/ipfs/docs/pulls{/number}","milestones_url":"https://api.github.com/repos/ipfs/docs/milestones{/number}","notifications_url":"https://api.github.com/repos/ipfs/docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/ipfs/docs/labels{/name}","releases_url":"https://api.github.com/repos/ipfs/docs/releases{/id}","deployments_url":"https://api.github.com/repos/ipfs/docs/deployments","created_at":"2017-03-03T18:21:15Z","updated_at":"2019-11-07T17:22:43Z","pushed_at":"2019-11-07T17:26:13Z","git_url":"git://github.com/ipfs/docs.git","ssh_url":"git@github.com:ipfs/docs.git","clone_url":"https://github.com/ipfs/docs.git","svn_url":"https://github.com/ipfs/docs","homepage":"https://docs.ipfs.io/","size":2823,"stargazers_count":65,"watchers_count":65,"language":"HTML","has_issues":true,"has_projects":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":45,"mirror_url":null,"archived":false,"disabled":false,"open_issues_count":93,"license":{"key":"other","name":"Other","spdx_id":"NOASSERTION","url":null,"node_id":"MDc6TGljZW5zZTA="},"forks":45,"open_issues":93,"watchers":65,"default_branch":"master"}},"base":{"label":"ipfs:master","ref":"master","sha":"b04a6684111f5ae23bd20591c72200dfd0621c6f","user":{"login":"ipfs","id":10536621,"node_id":"MDEyOk9yZ2FuaXphdGlvbjEwNTM2NjIx","avatar_url":"https://avatars0.githubusercontent.com/u/10536621?v=4","gravatar_id":"","url":"https://api.github.com/users/ipfs","html_url":"https://github.com/ipfs","followers_url":"https://api.github.com/users/ipfs/followers","following_url":"https://api.github.com/users/ipfs/following{/other_user}","gists_url":"https://api.github.com/users/ipfs/gists{/gist_id}","starred_url":"https://api.github.com/users/ipfs/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ipfs/subscriptions","organizations_url":"https://api.github.com/users/ipfs/orgs","repos_url":"https://api.github.com/users/ipfs/repos","events_url":"https://api.github.com/users/ipfs/events{/privacy}","received_events_url":"https://api.github.com/users/ipfs/received_events","type":"Organization","site_admin":false},"repo":{"id":83828178,"node_id":"MDEwOlJlcG9zaXRvcnk4MzgyODE3OA==","name":"docs","full_name":"ipfs/docs","private":false,"owner":{"login":"ipfs","id":10536621,"node_id":"MDEyOk9yZ2FuaXphdGlvbjEwNTM2NjIx","avatar_url":"https://avatars0.githubusercontent.com/u/10536621?v=4","gravatar_id":"","url":"https://api.github.com/users/ipfs","html_url":"https://github.com/ipfs","followers_url":"https://api.github.com/users/ipfs/followers","following_url":"https://api.github.com/users/ipfs/following{/other_user}","gists_url":"https://api.github.com/users/ipfs/gists{/gist_id}","starred_url":"https://api.github.com/users/ipfs/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ipfs/subscriptions","organizations_url":"https://api.github.com/users/ipfs/orgs","repos_url":"https://api.github.com/users/ipfs/repos","events_url":"https://api.github.com/users/ipfs/events{/privacy}","received_events_url":"https://api.github.com/users/ipfs/received_events","type":"Organization","site_admin":false},"html_url":"https://github.com/ipfs/docs","description":"🤖 📚 Documentation website for the IPFS project.","fork":false,"url":"https://api.github.com/repos/ipfs/docs","forks_url":"https://api.github.com/repos/ipfs/docs/forks","keys_url":"https://api.github.com/repos/ipfs/docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/ipfs/docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/ipfs/docs/teams","hooks_url":"https://api.github.com/repos/ipfs/docs/hooks","issue_events_url":"https://api.github.com/repos/ipfs/docs/issues/events{/number}","events_url":"https://api.github.com/repos/ipfs/docs/events","assignees_url":"https://api.github.com/repos/ipfs/docs/assignees{/user}","branches_url":"https://api.github.com/repos/ipfs/docs/branches{/branch}","tags_url":"https://api.github.com/repos/ipfs/docs/tags","blobs_url":"https://api.github.com/repos/ipfs/docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/ipfs/docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/ipfs/docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/ipfs/docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/ipfs/docs/statuses/{sha}","languages_url":"https://api.github.com/repos/ipfs/docs/languages","stargazers_url":"https://api.github.com/repos/ipfs/docs/stargazers","contributors_url":"https://api.github.com/repos/ipfs/docs/contributors","subscribers_url":"https://api.github.com/repos/ipfs/docs/subscribers","subscription_url":"https://api.github.com/repos/ipfs/docs/subscription","commits_url":"https://api.github.com/repos/ipfs/docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/ipfs/docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/ipfs/docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/ipfs/docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/ipfs/docs/contents/{+path}","compare_url":"https://api.github.com/repos/ipfs/docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/ipfs/docs/merges","archive_url":"https://api.github.com/repos/ipfs/docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/ipfs/docs/downloads","issues_url":"https://api.github.com/repos/ipfs/docs/issues{/number}","pulls_url":"https://api.github.com/repos/ipfs/docs/pulls{/number}","milestones_url":"https://api.github.com/repos/ipfs/docs/milestones{/number}","notifications_url":"https://api.github.com/repos/ipfs/docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/ipfs/docs/labels{/name}","releases_url":"https://api.github.com/repos/ipfs/docs/releases{/id}","deployments_url":"https://api.github.com/repos/ipfs/docs/deployments","created_at":"2017-03-03T18:21:15Z","updated_at":"2019-11-07T17:22:43Z","pushed_at":"2019-11-07T17:26:13Z","git_url":"git://github.com/ipfs/docs.git","ssh_url":"git@github.com:ipfs/docs.git","clone_url":"https://github.com/ipfs/docs.git","svn_url":"https://github.com/ipfs/docs","homepage":"https://docs.ipfs.io/","size":2823,"stargazers_count":65,"watchers_count":65,"language":"HTML","has_issues":true,"has_projects":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":45,"mirror_url":null,"archived":false,"disabled":false,"open_issues_count":93,"license":{"key":"other","name":"Other","spdx_id":"NOASSERTION","url":null,"node_id":"MDc6TGljZW5zZTA="},"forks":45,"open_issues":93,"watchers":65,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/ipfs/docs/pulls/369"},"html":{"href":"https://github.com/ipfs/docs/pull/369"},"issue":{"href":"https://api.github.com/repos/ipfs/docs/issues/369"},"comments":{"href":"https://api.github.com/repos/ipfs/docs/issues/369/comments"},"review_comments":{"href":"https://api.github.com/repos/ipfs/docs/pulls/369/comments"},"review_comment":{"href":"https://api.github.com/repos/ipfs/docs/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/ipfs/docs/pulls/369/commits"},"statuses":{"href":"https://api.github.com/repos/ipfs/docs/statuses/46b51e352aa537059fc9b9f0cdacaea5e52f0a22"}},"author_association":"COLLABORATOR"}}
{"actor":{"display_login":"jessicaschilling"}}