{"action":"created","comment":{"url":"https://api.github.com/repos/dart-lang/www.dartlang.org/pulls/comments/24694689","id":24694689,"diff_hunk":"@@ -7,29 +7,89 @@ title: \"Publishing a Package\"\n \n # {{ page.title }}\n \n-[Pub](/tools/pub) isn't just for using other people's packages. It also allows you to share\n-your packages with the world. Once you've written some useful code and you want\n-everyone else to be able to use it, just run:\n+[Pub](/tools/pub) isn't just for using other people's packages.\n+It also allows you to share your packages with the world. If you have a useful\n+project and you want others to be able to use it, use the `pub publish`\n+command. For your first time around, you can perform a dry run like so:\n+\n+{% prettify sh %}\n+$ pub publish --dry-run\n+{% endprettify %}\n+\n+Pub will check to make sure that your package follows the\n+[pubspec format](pubspec.html) and\n+[package layout conventions](package-layout.html), and then upload your package\n+to [pub.dartlang.org](https://pub.dartlang.org). Pub will also show you all of\n+the files it intends to \"publish\". Here's an example of publishing a package\n+named `transmogrify`:\n+\n+{% prettify none %}\n+Publishing transmogrify 1.0.0 to https://pub.dartlang.org:\n+    .gitignore\n+    CHANGELOG.md\n+    README.md\n+    lib\n+        transmogrify.dart\n+        src\n+            transmogrifier.dart\n+            transmogrification.dart\n+    pubspec.yaml\n+    test\n+        transmogrify_test.dart\n+\n+Package has 0 warnings.\n+{% endprettify %}\n+\n+To publish your package for reals, remove the `--dry-run` argument:\n \n {% prettify sh %}\n $ pub publish\n {% endprettify %}\n \n-Pub will check to make sure that your package follows the [pubspec\n-format](pubspec.html) and [package layout conventions](package-layout.html),\n-and then upload your package to [pub.dartlang.org](http://pub.dartlang.org).\n-Then any Pub user will be able to download it or depend on it in their\n-pubspecs. For example, if you just published version 1.0.0 of a package named\n-`transmogrify`, then they can write:\n+After your package has been successfully uploaded to\n+[pub.dartlang.org](https://pub.dartlang.org/), any Pub user will be able to\n+download it or depend on it in their projects. For example, if you just\n+published version 1.0.0 of your `transmogrify` package, then another Dart\n+developer can add it as a dependency in their `pubspec.yaml`:\n \n {% prettify yaml %}\n dependencies:\n   transmogrify: \">= 1.0.0 < 2.0.0\"\n {% endprettify %}\n \n+## Important files\n+\n+When you publish your package to [pub.dartlang.org](https://pub.dartlang.org/),\n+it gets its very own page at pub.dartlang.org/packages/<your_package>. This\n+page uses content from files in your package, and contains several sections:\n+\n+* **README**: If your package includes a README file, then it will be shown as\n+  the main content at your package's pub.dartlang.org URL.\n+\n+* **CHANGLOG**: If your package includes a CHANGELOG file, that will be listed","path":"src/site/tools/pub/publishing.markdown","position":72,"original_position":72,"commit_id":"f78e03ee52d8f9384da12173d91bf7905f4ab94b","original_commit_id":"f78e03ee52d8f9384da12173d91bf7905f4ab94b","user":{"login":"sethladd","id":5479,"avatar_url":"https://avatars.githubusercontent.com/u/5479?v=3","gravatar_id":"","url":"https://api.github.com/users/sethladd","html_url":"https://github.com/sethladd","followers_url":"https://api.github.com/users/sethladd/followers","following_url":"https://api.github.com/users/sethladd/following{/other_user}","gists_url":"https://api.github.com/users/sethladd/gists{/gist_id}","starred_url":"https://api.github.com/users/sethladd/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/sethladd/subscriptions","organizations_url":"https://api.github.com/users/sethladd/orgs","repos_url":"https://api.github.com/users/sethladd/repos","events_url":"https://api.github.com/users/sethladd/events{/privacy}","received_events_url":"https://api.github.com/users/sethladd/received_events","type":"User","site_admin":false},"body":"also, CHANGELOG.md","created_at":"2015-02-13T20:38:00Z","updated_at":"2015-02-13T20:38:00Z","html_url":"https://github.com/dart-lang/www.dartlang.org/pull/1252#discussion_r24694689","pull_request_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/pulls/1252","_links":{"self":{"href":"https://api.github.com/repos/dart-lang/www.dartlang.org/pulls/comments/24694689"},"html":{"href":"https://github.com/dart-lang/www.dartlang.org/pull/1252#discussion_r24694689"},"pull_request":{"href":"https://api.github.com/repos/dart-lang/www.dartlang.org/pulls/1252"}}},"pull_request":{"url":"https://api.github.com/repos/dart-lang/www.dartlang.org/pulls/1252","id":29290220,"html_url":"https://github.com/dart-lang/www.dartlang.org/pull/1252","diff_url":"https://github.com/dart-lang/www.dartlang.org/pull/1252.diff","patch_url":"https://github.com/dart-lang/www.dartlang.org/pull/1252.patch","issue_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/issues/1252","number":1252,"state":"open","locked":false,"title":"First whack at improving the Publishing a Package page","user":{"login":"srawlins","id":103167,"avatar_url":"https://avatars.githubusercontent.com/u/103167?v=3","gravatar_id":"","url":"https://api.github.com/users/srawlins","html_url":"https://github.com/srawlins","followers_url":"https://api.github.com/users/srawlins/followers","following_url":"https://api.github.com/users/srawlins/following{/other_user}","gists_url":"https://api.github.com/users/srawlins/gists{/gist_id}","starred_url":"https://api.github.com/users/srawlins/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/srawlins/subscriptions","organizations_url":"https://api.github.com/users/srawlins/orgs","repos_url":"https://api.github.com/users/srawlins/repos","events_url":"https://api.github.com/users/srawlins/events{/privacy}","received_events_url":"https://api.github.com/users/srawlins/received_events","type":"User","site_admin":false},"body":"Fixes #1251 \r\n\r\nStaged: https://pub-publish-dot-dart-lang.appspot.com/tools/pub/publishing.html","created_at":"2015-02-13T19:09:06Z","updated_at":"2015-02-13T20:38:00Z","closed_at":null,"merged_at":null,"merge_commit_sha":"b1bc4486313f3816029958d3a7ae23da6200212a","assignee":{"login":"kwalrath","id":2164483,"avatar_url":"https://avatars.githubusercontent.com/u/2164483?v=3","gravatar_id":"","url":"https://api.github.com/users/kwalrath","html_url":"https://github.com/kwalrath","followers_url":"https://api.github.com/users/kwalrath/followers","following_url":"https://api.github.com/users/kwalrath/following{/other_user}","gists_url":"https://api.github.com/users/kwalrath/gists{/gist_id}","starred_url":"https://api.github.com/users/kwalrath/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kwalrath/subscriptions","organizations_url":"https://api.github.com/users/kwalrath/orgs","repos_url":"https://api.github.com/users/kwalrath/repos","events_url":"https://api.github.com/users/kwalrath/events{/privacy}","received_events_url":"https://api.github.com/users/kwalrath/received_events","type":"User","site_admin":false},"milestone":null,"commits_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/pulls/1252/commits","review_comments_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/pulls/1252/comments","review_comment_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/pulls/comments/{number}","comments_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/issues/1252/comments","statuses_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/statuses/f78e03ee52d8f9384da12173d91bf7905f4ab94b","head":{"label":"srawlins:pub-publish","ref":"pub-publish","sha":"f78e03ee52d8f9384da12173d91bf7905f4ab94b","user":{"login":"srawlins","id":103167,"avatar_url":"https://avatars.githubusercontent.com/u/103167?v=3","gravatar_id":"","url":"https://api.github.com/users/srawlins","html_url":"https://github.com/srawlins","followers_url":"https://api.github.com/users/srawlins/followers","following_url":"https://api.github.com/users/srawlins/following{/other_user}","gists_url":"https://api.github.com/users/srawlins/gists{/gist_id}","starred_url":"https://api.github.com/users/srawlins/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/srawlins/subscriptions","organizations_url":"https://api.github.com/users/srawlins/orgs","repos_url":"https://api.github.com/users/srawlins/repos","events_url":"https://api.github.com/users/srawlins/events{/privacy}","received_events_url":"https://api.github.com/users/srawlins/received_events","type":"User","site_admin":false},"repo":{"id":20624339,"name":"dartlang.org","full_name":"srawlins/dartlang.org","owner":{"login":"srawlins","id":103167,"avatar_url":"https://avatars.githubusercontent.com/u/103167?v=3","gravatar_id":"","url":"https://api.github.com/users/srawlins","html_url":"https://github.com/srawlins","followers_url":"https://api.github.com/users/srawlins/followers","following_url":"https://api.github.com/users/srawlins/following{/other_user}","gists_url":"https://api.github.com/users/srawlins/gists{/gist_id}","starred_url":"https://api.github.com/users/srawlins/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/srawlins/subscriptions","organizations_url":"https://api.github.com/users/srawlins/orgs","repos_url":"https://api.github.com/users/srawlins/repos","events_url":"https://api.github.com/users/srawlins/events{/privacy}","received_events_url":"https://api.github.com/users/srawlins/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/srawlins/dartlang.org","description":"Documentation for the Dart language and tools.","fork":true,"url":"https://api.github.com/repos/srawlins/dartlang.org","forks_url":"https://api.github.com/repos/srawlins/dartlang.org/forks","keys_url":"https://api.github.com/repos/srawlins/dartlang.org/keys{/key_id}","collaborators_url":"https://api.github.com/repos/srawlins/dartlang.org/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/srawlins/dartlang.org/teams","hooks_url":"https://api.github.com/repos/srawlins/dartlang.org/hooks","issue_events_url":"https://api.github.com/repos/srawlins/dartlang.org/issues/events{/number}","events_url":"https://api.github.com/repos/srawlins/dartlang.org/events","assignees_url":"https://api.github.com/repos/srawlins/dartlang.org/assignees{/user}","branches_url":"https://api.github.com/repos/srawlins/dartlang.org/branches{/branch}","tags_url":"https://api.github.com/repos/srawlins/dartlang.org/tags","blobs_url":"https://api.github.com/repos/srawlins/dartlang.org/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/srawlins/dartlang.org/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/srawlins/dartlang.org/git/refs{/sha}","trees_url":"https://api.github.com/repos/srawlins/dartlang.org/git/trees{/sha}","statuses_url":"https://api.github.com/repos/srawlins/dartlang.org/statuses/{sha}","languages_url":"https://api.github.com/repos/srawlins/dartlang.org/languages","stargazers_url":"https://api.github.com/repos/srawlins/dartlang.org/stargazers","contributors_url":"https://api.github.com/repos/srawlins/dartlang.org/contributors","subscribers_url":"https://api.github.com/repos/srawlins/dartlang.org/subscribers","subscription_url":"https://api.github.com/repos/srawlins/dartlang.org/subscription","commits_url":"https://api.github.com/repos/srawlins/dartlang.org/commits{/sha}","git_commits_url":"https://api.github.com/repos/srawlins/dartlang.org/git/commits{/sha}","comments_url":"https://api.github.com/repos/srawlins/dartlang.org/comments{/number}","issue_comment_url":"https://api.github.com/repos/srawlins/dartlang.org/issues/comments/{number}","contents_url":"https://api.github.com/repos/srawlins/dartlang.org/contents/{+path}","compare_url":"https://api.github.com/repos/srawlins/dartlang.org/compare/{base}...{head}","merges_url":"https://api.github.com/repos/srawlins/dartlang.org/merges","archive_url":"https://api.github.com/repos/srawlins/dartlang.org/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/srawlins/dartlang.org/downloads","issues_url":"https://api.github.com/repos/srawlins/dartlang.org/issues{/number}","pulls_url":"https://api.github.com/repos/srawlins/dartlang.org/pulls{/number}","milestones_url":"https://api.github.com/repos/srawlins/dartlang.org/milestones{/number}","notifications_url":"https://api.github.com/repos/srawlins/dartlang.org/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/srawlins/dartlang.org/labels{/name}","releases_url":"https://api.github.com/repos/srawlins/dartlang.org/releases{/id}","created_at":"2014-06-08T19:17:32Z","updated_at":"2014-08-29T19:37:18Z","pushed_at":"2015-02-13T20:21:08Z","git_url":"git://github.com/srawlins/dartlang.org.git","ssh_url":"git@github.com:srawlins/dartlang.org.git","clone_url":"https://github.com/srawlins/dartlang.org.git","svn_url":"https://github.com/srawlins/dartlang.org","homepage":"http://www.dartlang.org","size":348989,"stargazers_count":0,"watchers_count":0,"language":"JavaScript","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":"dart-lang:master","ref":"master","sha":"25856bf837f204b1188443f2591b486efb74ed56","user":{"login":"dart-lang","id":1609975,"avatar_url":"https://avatars.githubusercontent.com/u/1609975?v=3","gravatar_id":"","url":"https://api.github.com/users/dart-lang","html_url":"https://github.com/dart-lang","followers_url":"https://api.github.com/users/dart-lang/followers","following_url":"https://api.github.com/users/dart-lang/following{/other_user}","gists_url":"https://api.github.com/users/dart-lang/gists{/gist_id}","starred_url":"https://api.github.com/users/dart-lang/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dart-lang/subscriptions","organizations_url":"https://api.github.com/users/dart-lang/orgs","repos_url":"https://api.github.com/users/dart-lang/repos","events_url":"https://api.github.com/users/dart-lang/events{/privacy}","received_events_url":"https://api.github.com/users/dart-lang/received_events","type":"Organization","site_admin":false},"repo":{"id":5441793,"name":"www.dartlang.org","full_name":"dart-lang/www.dartlang.org","owner":{"login":"dart-lang","id":1609975,"avatar_url":"https://avatars.githubusercontent.com/u/1609975?v=3","gravatar_id":"","url":"https://api.github.com/users/dart-lang","html_url":"https://github.com/dart-lang","followers_url":"https://api.github.com/users/dart-lang/followers","following_url":"https://api.github.com/users/dart-lang/following{/other_user}","gists_url":"https://api.github.com/users/dart-lang/gists{/gist_id}","starred_url":"https://api.github.com/users/dart-lang/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dart-lang/subscriptions","organizations_url":"https://api.github.com/users/dart-lang/orgs","repos_url":"https://api.github.com/users/dart-lang/repos","events_url":"https://api.github.com/users/dart-lang/events{/privacy}","received_events_url":"https://api.github.com/users/dart-lang/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/dart-lang/www.dartlang.org","description":"Documentation for the Dart language and tools","fork":false,"url":"https://api.github.com/repos/dart-lang/www.dartlang.org","forks_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/forks","keys_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/keys{/key_id}","collaborators_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/teams","hooks_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/hooks","issue_events_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/issues/events{/number}","events_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/events","assignees_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/assignees{/user}","branches_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/branches{/branch}","tags_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/tags","blobs_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/git/refs{/sha}","trees_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/git/trees{/sha}","statuses_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/statuses/{sha}","languages_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/languages","stargazers_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/stargazers","contributors_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/contributors","subscribers_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/subscribers","subscription_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/subscription","commits_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/commits{/sha}","git_commits_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/git/commits{/sha}","comments_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/comments{/number}","issue_comment_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/issues/comments/{number}","contents_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/contents/{+path}","compare_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/compare/{base}...{head}","merges_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/merges","archive_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/downloads","issues_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/issues{/number}","pulls_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/pulls{/number}","milestones_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/milestones{/number}","notifications_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/labels{/name}","releases_url":"https://api.github.com/repos/dart-lang/www.dartlang.org/releases{/id}","created_at":"2012-08-16T16:56:30Z","updated_at":"2015-02-13T19:56:47Z","pushed_at":"2015-02-13T19:56:49Z","git_url":"git://github.com/dart-lang/www.dartlang.org.git","ssh_url":"git@github.com:dart-lang/www.dartlang.org.git","clone_url":"https://github.com/dart-lang/www.dartlang.org.git","svn_url":"https://github.com/dart-lang/www.dartlang.org","homepage":"https://www.dartlang.org","size":445162,"stargazers_count":166,"watchers_count":166,"language":"JavaScript","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":141,"mirror_url":null,"open_issues_count":129,"forks":141,"open_issues":129,"watchers":166,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/dart-lang/www.dartlang.org/pulls/1252"},"html":{"href":"https://github.com/dart-lang/www.dartlang.org/pull/1252"},"issue":{"href":"https://api.github.com/repos/dart-lang/www.dartlang.org/issues/1252"},"comments":{"href":"https://api.github.com/repos/dart-lang/www.dartlang.org/issues/1252/comments"},"review_comments":{"href":"https://api.github.com/repos/dart-lang/www.dartlang.org/pulls/1252/comments"},"review_comment":{"href":"https://api.github.com/repos/dart-lang/www.dartlang.org/pulls/comments/{number}"},"commits":{"href":"https://api.github.com/repos/dart-lang/www.dartlang.org/pulls/1252/commits"},"statuses":{"href":"https://api.github.com/repos/dart-lang/www.dartlang.org/statuses/f78e03ee52d8f9384da12173d91bf7905f4ab94b"}}}}