Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(509)

Unified Diff: src/site/docs/pub-package-manager/pubspec.markdown

Issue 10891023: add a name: and mark it as required (Closed) Base URL: git@github.com:dart-lang/dartlang.org.git@master
Patch Set: tweak to instructions Created 8 years, 4 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
Index: src/site/docs/pub-package-manager/pubspec.markdown
diff --git a/src/site/docs/pub-package-manager/pubspec.markdown b/src/site/docs/pub-package-manager/pubspec.markdown
index 12f437d3253c066b6ad9c615d156836e49386cff..2a93cb77147355dc4279f8d5e78ee0764a619eea 100644
--- a/src/site/docs/pub-package-manager/pubspec.markdown
+++ b/src/site/docs/pub-package-manager/pubspec.markdown
@@ -29,10 +29,12 @@ dependencies:
## Name
-Every package needs a name. When your stellar code gets props on the world
-stage, this is what they'll be hollering. Also, it's how other packages will
-refer to yours, and how it will appear on [pub.dartlang.org][pubsite], should
-you publish it.
+**Required**
+
+Every package needs a name. When your stellar code gets props on
+the world stage, this is what they'll be hollering. Also, it's how other
+packages will refer to yours, and how it will appear on
+[pub.dartlang.org][pubsite], should you publish it.
It should be all lowercase, with underscores to separate words,
`just_like_this`. Stick with basic Latin letters and Arabic digits:
@@ -45,7 +47,11 @@ save you heartache later.
## Version
-Every package has a version. No one really gets excited about versioning, but
+Every package has a version. A version number is required to host your package on
+[pub.dartlang.org][pubsite], but can be omitted for local-only packages. If you
+omit it, your package is implicitly versioned `0.0.0`.
+
+No one really gets excited about versioning, but
it's a necessary evil for reusing code while letting it evolve quickly. A
version number is three numbers separated by dots, like `0.2.43`. It can also
optionally have a build (`+hotfix.oopsie`) or pre-release (`-alpha.12`) suffix.
@@ -60,10 +66,6 @@ yourself for hordes of angry users.
[semantic versioning]: http://semver.org
-A version number is required to host your package on
-[pub.dartlang.org][pubsite], but can be omitted for local-only packages. If you
-omit it, your package is implicitly versioned `0.0.0`.
-
## Description
This is optional for your own personal packages, but if you intend to share
« no previous file with comments | « src/site/docs/pub-package-manager/index.markdown ('k') | src/site/docs/pub-package-manager/versioning.markdown » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698