| 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
|
|
|