Bad upgrade path from TJ’s serve

[yuchi]

Hallo!

Nice to see serve is having a new function! But I see stuff breaking because I expected it to just be a new version of the package, which is not.

Could you at least give some information if someone is trying to render Jade files and similar that this is not that serve?

[derhuerst]

To make it clear: You're talking about that serve?

[yuchi]

@derhuerst Exactly ^~^

[yuchi]

That docs still say it is called serve on npm!

[derhuerst]

npm info serve@1.4.0 author
# TJ Holowaychuk <tj@vision-media.ca>

npm info serve@2.0.0 author
# leo

serve@1.4.0 – tj/serve
serve@2.0.0 – this repo

[derhuerst]

This should probably be mentioned in the docs of tj/serve.

[yuchi]

In fact I currently solved it by installing 1.x.

[leo]

According to the SemVer spec, we acted just right. Consider this change a complete rewrite of the package (which, in turn, is considered a major/breaking SemVer change).

Please use the old version of the package, if you'd like to take advantage of the functionalities that existed before the "rewrite".

😊

[derhuerst]

@yuchi Would you submit a PR at tj/serve to clarify in the docs that server>=2 is in a different repo?

[yuchi]

@leo that's right. Obviously right. But a small note should do the job.

[yuchi]

@derhuerst I will.