Skip to content

Conversation

jasnell
Copy link
Member

@jasnell jasnell commented May 30, 2017

@cjihrig @mcollina @nodejs/ctc @ZibbyKeaton ... here's the draft. PTAL

@jasnell jasnell changed the title blog: add release post for 8.0.0 [WIP] blog: add release post for 8.0.0 May 30, 2017
Copy link
Member

Choose a reason for hiding this comment

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

Nit: Simplify:

This article contains a summary of the most significant changes and features.

Copy link
Member

Choose a reason for hiding this comment

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

Nit: noticeable and significant -> significant; application performance -> performance

Copy link
Member

Choose a reason for hiding this comment

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

Nit: Remove To mitigate the loss in performance

Copy link
Member

Choose a reason for hiding this comment

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

At a minimum: considered to be unsupported -> deprecated

But really, I'd say remove this sentence altogether. We can't truly guarantee that it will not be removed from Node.js ever (although I agree it's unlikely).

Copy link
Member

Choose a reason for hiding this comment

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

Nit: remove comma after time (but leave the one after environments)

Copy link
Member

Choose a reason for hiding this comment

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

an fully supported -> a fully supported

I think this paragraph is a fair bit too wordy. Something succinct might be better. Maybe drop a couple sentences so it looks like this?:

The legacy command line debugger is being removed in Node.js 8. As a command
line replacement, node-inspect has been integrated directly into the Node.js
runtime. Additionally, the V8 Inspector debugger, which arrived previously as
an experimental feature in Node.js 6, is being upgraded to a fully supported
feature.

Copy link
Member

Choose a reason for hiding this comment

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

Nit: Remove considered. (It's either experimental or it's not. Rather than provide clarity, 'considered' just muddies things.)

Copy link
Member

Choose a reason for hiding this comment

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

Nit: remove still considered

Copy link
Member

Choose a reason for hiding this comment

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

Nit: Remove As an even numbered release,

Nit: represents -> is

Copy link
Member

Choose a reason for hiding this comment

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

October -> October 2017

Copy link
Member

Choose a reason for hiding this comment

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

Nit: Remove once the Node.js 8 release line has had several months to completely stabilize

Copy link
Member

Choose a reason for hiding this comment

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

Nit: Change first sentence in this paragraph to Note that we have dropped the "v" in Node.js 8.

Copy link
Member

Choose a reason for hiding this comment

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

we've decided to simply drop -> we've dropped

Copy link
Member

@Trott Trott left a comment

Choose a reason for hiding this comment

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

Left a bunch of nits, but overall: Wow, this is a lot to summarize and you've organized it well. 👍

@jasnell
Copy link
Member Author

jasnell commented May 30, 2017

Updated to address the comments. Will update again once the release is out.

@Trott
Copy link
Member

Trott commented May 30, 2017

/cc @nodejs/documentation

Copy link
Member

@mhdawson mhdawson left a comment

Choose a reason for hiding this comment

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

LGTM

Copy link
Contributor

Choose a reason for hiding this comment

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

A nit: unnecessary space before semicolon.

Copy link
Contributor

Choose a reason for hiding this comment

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

Wrong quotes, parsing error.

Copy link
Contributor

Choose a reason for hiding this comment

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

  1. Wrong quotes, parsing error.
  2. Maybe (message) => { /** ... **/ } ?

Choose a reason for hiding this comment

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

also funny quotes on require(‘inspector’)

Copy link
Contributor

Choose a reason for hiding this comment

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

It seems they are also fixed)

@jasnell jasnell changed the title [WIP] blog: add release post for 8.0.0 blog: add release post for 8.0.0 May 30, 2017
@jasnell
Copy link
Member Author

jasnell commented May 30, 2017

Landed with fixes made. Thank you all

@jasnell jasnell closed this May 30, 2017
@lpinca
Copy link
Member

lpinca commented May 30, 2017

@jasnell I think you only pushed on your fork.

@jasnell
Copy link
Member Author

jasnell commented May 30, 2017

I need a beer. fixing

jasnell added a commit that referenced this pull request May 30, 2017
@vsemozhetbyt
Copy link
Contributor

vsemozhetbyt commented May 30, 2017

Sorry, is this OK:

Information for static error codes can be queried quickly by referencing the Node.js documentation. For instance, the URL to lookup information about the ERR_ASSERTION error code is https://nodejs.org/dist/latest-v7.x/docs/api/errors.html#ERR_ASSERTION.

Should this be ...latest-v7.x...? And there is no ERR_ASSERTION still in the https://github.com/nodejs/node/blob/master/doc/api/errors.md, so the link is wrong both for v7 and v8.

@vsemozhetbyt
Copy link
Contributor

Processing warnings such as deprecations may now to redirected to a file

to redirected -> be redirected ?

@vsemozhetbyt
Copy link
Contributor

vsemozhetbyt commented May 30, 2017

The npm client has been updated to 5.0.0 [3c3b36af0f] #12936.

These are links for the beta, maybe they should be the nodejs/node@c58cea5 and nodejs/node#13276 instead.

@vsemozhetbyt
Copy link
Contributor

vsemozhetbyt commented May 30, 2017

NODE_MODULE_VERSION has been updated to 57 (nodejs/node@ec7cbaf266)] #12995.

Wrong link formatting, wrong (not shortened) rendering in the https://nodejs.org/en/blog/release/v8.0.0/

See also nodejs/node#13313

@vsemozhetbyt
Copy link
Contributor

vsemozhetbyt commented May 30, 2017

Maybe it is too late for this, but should not we mention in notable changes some cli changes versus v6, like:

nodejs/node#12028
nodejs/node#13012
nodejs/node#10651

@vsemozhetbyt
Copy link
Contributor

@jasnell , @Trott , @nodejs/documentation
Sorry for being so late. Can we still fix the last nits? I am not sure about some of them and about the procedure now.

@Trott
Copy link
Member

Trott commented May 30, 2017

I am not sure about some of them and about the procedure now.

Procedure might be to open a pull request to make the changes. /cc @nodejs/website in case I'm wrong about that...

@vsemozhetbyt
Copy link
Contributor

@Trott PTAL: #1244

@jasnell
Copy link
Member Author

jasnell commented May 30, 2017

@vsemozhetbyt ... no problems :-) we can make edits to the blog post. Just add commits to the PR I see you've already opened :-)


Zero-filling new instances of `Buffer(num)` by default will have a significant
impact on performance. Developers should move to the new
`Buffer.allocUnsafe(num)` API if they wish to allocate `Buffer` instances
Copy link
Member

Choose a reason for hiding this comment

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

This probably should have also mentioned Buffer.alloc (for consistent behaviour between versions), and an additional warning against using uninitialized memory allocations.

@jasnell, would it be acceptable to update the release post now? If yes, I will be willing to propose a small patch.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

10 participants