Node: Documentation with breaking changes between version 6 to version 8

[ghost]

• Version: 8.0.0
• Platform: All
• Subsystem: documentation

As a user of node I would like to see a document detailing breaking changes between node 6 and node 8, or, node 7 to node 8, such as this one (just for different versions).

[cjihrig]

I think @Fishrock123 has handled these in the past. This seems like something for @nodejs/documentation

[mscdex]

Although there shouldn't be anymore breaking changes on the node side of things from now until v8.x goes LTS in October, I am not sure if we should wait until we see what version of V8 will be used in the first LTS release. While node core will be ABI compatible with the various V8 versions (5.9, 6.0, and possibly 6.1 now), I'm not sure if we traditionally document any V8 changes that may break userland (despite nan/n-api)?

[gibfahn]

Yeah, previous discussion was to do this when Node 8 goes LTS. I can't remember which issue it was though.

[TinOo512]

Now that Node 8 became the new LTS is there any update on that?

[vsemozhetbyt]

Does Semver-Major section suffice?

[TinOo512]

@vsemozhetbyt Thx, this is nice! I'm still seeing value to have a migration guide at least between LTS versions.

[gibfahn]

@vsemozhetbyt if you're moving from Node 6 to Node 8, you actually need the list of semver-majors in v7.0.0 and v8.0.0:

https://nodejs.org/en/blog/release/v7.0.0/#commits
https://nodejs.org/en/blog/release/v8.0.0/#semver-major-commits

I agree we should publish a separate guide though.

[ghost]

There is this document now, this seems sufficient.
https://github.com/nodejs/node/wiki/Breaking-changes-between-v6-LTS-and-v8-LTS

[bengl]

@arboreal84 looks like it's good for you, so I'll close this.

[ColinWhitmarsh]

Has the wiki moved? The link doesn't appear to work anymore

[vsemozhetbyt]

@ColinWhitmarsh It is archived in https://github.com/nodejs/wiki-archive
See also: https://github.com/nodejs/TSC/issues/525

[pgn-vole]

Here is a direct link: https://github.com/nodejs/wiki-archive/blob/master/Breaking-changes-between-v6-LTS-and-v8-LTS.md