Skip to content
This repository has been archived by the owner on Aug 11, 2022. It is now read-only.

npm-dist-tag docs: Explain why the latest tag matters #10787

Closed
wants to merge 1 commit into from
Closed

npm-dist-tag docs: Explain why the latest tag matters #10787

wants to merge 1 commit into from

Conversation

cvrebert
Copy link
Contributor

  • Explain why one would care about the latest tag, by explaining its special significance to npm install. Currently, only its default status with respect to npm publish is mentioned.
  • Also, avoid using npm as a meta-example, as this causes confusion between npm-the-tool and npm-the-project. The old docs made it sound like the next tag might've has special significance to npm-the-tool, when it was instead talking about npm-the-project (AFAIK).
  • Mention common practice regarding tagging unstable releases, as this is not universally known.
    • Include the term "prerelease" for SEO's sake

Refs twbs/bootstrap#18520

* Explain why one would care about the `latest` tag, by explaining its special significance to `npm install`. Currently, only its default status with respect to `npm publish` is mentioned.
* Also, avoid using npm as a meta-example, as this causes confusion between npm-the-tool and npm-the-project. The old docs made it sound like the `next` tag might've has special significance to npm-the-tool, when it was instead talking about npm-the-project (AFAIK).
* Mention common practice regarding tagging unstable releases, as this is not universally known.
  * Include the term "prerelease" for SEO's sake
@iarna iarna added this to the release-3.5.4 milestone Dec 18, 2015
iarna pushed a commit that referenced this pull request Dec 18, 2015
* Explain why one would care about the `latest` tag, by explaining its special significance to `npm install`. Currently, only its default status with respect to `npm publish` is mentioned.
* Also, avoid using npm as a meta-example, as this causes confusion between npm-the-tool and npm-the-project. The old docs made it sound like the `next` tag might've has special significance to npm-the-tool, when it was instead talking about npm-the-project (AFAIK).
* Mention common practice regarding tagging unstable releases, as this is not universally known.
  * Include the term "prerelease" for SEO's sake

PR-URL: #10787
Credit: @cvrebert
iarna pushed a commit that referenced this pull request Dec 18, 2015
For uniformity with the docs for the "publish" command, use code formatting for tag names in the docs for the "dist-tag" command.

PR-URL: #10787
Credit: @cvrebert
iarna pushed a commit that referenced this pull request Jan 7, 2016
* Explain why one would care about the `latest` tag, by explaining its
  special significance to `npm install`.  Currently, only its default status
  with respect to `npm publish` is mentioned.
* Also, avoid using npm as a meta-example, as this causes confusion between
  npm-the-tool and npm-the-project.  The old docs made it sound like the
  `next` tag might've has special significance to npm-the-tool, when it was
  instead talking about npm-the-project (AFAIK).
* Mention common practice regarding tagging unstable releases, as this is
  not universally known.
  * Include the term "prerelease" for SEO's sake

PR-URL: #10787
Credit: @cvrebert
iarna pushed a commit that referenced this pull request Jan 7, 2016
For uniformity with the docs for the "publish" command, use code formatting for tag names in the docs for the "dist-tag" command.

PR-URL: #10787
Credit: @cvrebert
@iarna
Copy link
Contributor

iarna commented Jan 12, 2016

This landed in v3.5.4 and is still awaiting merge to LTS.

@iarna iarna modified the milestones: next, 3.5.4 Jan 12, 2016
zkat pushed a commit that referenced this pull request Jan 19, 2016
* Explain why one would care about the `latest` tag, by explaining
  its special significance to `npm install`. Currently, only its
  default status with respect to `npm publish` is mentioned.
* Also, avoid using npm as a meta-example, as this causes confusion
  between npm-the-tool and npm-the-project. The old docs made it sound
  like the `next` tag might've has special significance to
  npm-the-tool, when it was instead talking about npm-the-project
* Mention common practice regarding tagging unstable releases, as this
  is not universally known.
* Include the term "prerelease" for SEO's sake

PR-URL: #10787
Credit: @cvrebert
@iarna
Copy link
Contributor

iarna commented Jan 25, 2016

This landed in 2.14.16 =)

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants