Skip to content

Added notice for 4.0.0 vs 3.9.1 documentation#2121

Merged
phated merged 1 commit into
gulpjs:masterfrom
Lucretiel:master
Feb 7, 2018
Merged

Added notice for 4.0.0 vs 3.9.1 documentation#2121
phated merged 1 commit into
gulpjs:masterfrom
Lucretiel:master

Conversation

@Lucretiel

@Lucretiel Lucretiel commented Feb 7, 2018

Copy link
Copy Markdown
Contributor

Because the master branch is the authoritative source of documentation, it can be confusing for developers who have used npm install gulp (or joined a project using gulp 3) that the master branch is for a different major release. This PR adds a simple notification to the API docs, which are linked to from https://gulpjs.com/, that the standard version installed by npm install gulp.

It's worth noting that, while it might be obvious to people familiar with gulp's development, there's no indication that there's a mismatch between master and the current node release anywhere on https://gulpjs.com/, nor on master:docs/API.md, nor in any of the top google search results for "gulpjs documentation".

@phated

phated commented Feb 7, 2018

Copy link
Copy Markdown
Member

Thanks. Can you also update the website to point to docs at the correct tag? The repo is gulpjs.github.io

@Lucretiel

Copy link
Copy Markdown
Contributor Author

Oh, I couldn't find the repo at first. Will do.

@yocontra

yocontra commented Feb 7, 2018

Copy link
Copy Markdown
Member

@Lucretiel Thanks! This should reduce confusion.

@phated phated merged commit 126423a into gulpjs:master Feb 7, 2018

@phated phated left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think I'll change "standard" to "default" when I'm back at a computer.

@Lucretiel

Lucretiel commented Feb 7, 2018 via email

Copy link
Copy Markdown
Contributor Author

@phated

phated commented Feb 7, 2018

Copy link
Copy Markdown
Member

Stable specifically means "not prerelease" and 4.0.0 has been released (it's just not default because the docs aren't complete)

@Lucretiel

Lucretiel commented Feb 7, 2018 via email

Copy link
Copy Markdown
Contributor Author

@kuraga

This comment has been minimized.

@gulpjs gulpjs locked and limited conversation to collaborators Sep 18, 2018
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants