Release proposal: v1.3.0

[rvagg]

I wrote a tool, changelog-maker to generate this changelog. It uses the metadata to cross-reference the PR-URL, include that in the summary and also note anything that's labelled with semver* labels so they stand out (see the entry for 77f35861d0 above).

The only concern I have with this is that it makes the plain-text version of the CHANGELOG.md file very unweildy and difficult to read.. e.g. one line will look like this:

* [[`fb28c91074`](https://github.com/iojs/io.js/commit/fb28c91074)] -
**src**: fix add-on builds, partially revert 8aed9d66 (Ben Noordhuis)
[#868](https://github.com/iojs/io.js/pull/868) 

So .. before I go putting this in CHANGELOG.md, please comment if you think this is going to be a problem. My preference is for this to be a useful Markdown doc, but perhaps it will bother others enough to object!

Re 1.3.0: I think we'll give this ~2 days before it's released if there are no objections.

[YurySolovyov]

isn't it better so sort those commits by category ?

[rvagg]

@YuriSolovyov yeah, that'd be nice, but I suspect that the ordering matters more than being able to view them as a group. I'll do a "Notable changes" that has things grouped.

Also, the above list is in reverse order, I've decided that this probably isn't a good idea so I'll switch it before publishing.

[YurySolovyov]

well, that was a "minimal" proposal, that just require tweaking your script/tool
I think creating "Notable changes" requires more work since you have to always pick changes that seem "notable", and this is more work to do.
thanks for looking at it anyway.

[aheckmann]

RE: ordering vs categorizing. What I found worked well for me in the past
is a combination of both. Categorize them but within each category, order
by commit date.

On Wed, Feb 18, 2015 at 2:57 AM, Yuri notifications@github.com wrote:

well, that was a "minimal" proposal, that just require tweaking your
script/tool
I think creating "Notable changes" requires more work since you have to
always pick changes that seem "notable", and this is more work to do.
thanks for looking at it anyway.

—
Reply to this email directly or view it on GitHub
#872 (comment).

Aaron
@aaronheckmann https://twitter.com/#!/aaronheckmann
soundcloud.com/ajhecky
github.com/aheckmann

[silverwind]

Regarding #826: Please mention in the release notes that TLS (and in turn HTTPS) now rely on a stronger default cipher suite which excludes the RC4 cipher. If users still want to use RC4, they have to specify their own ciphers.

Also, I'd appreciate if someone could review #845 before this release. This should be in the docs for this release. Edit: It's merged!

[rvagg]

https://iojs.org/download/nightly/v1.2.1-nightly20150218fb28c91074/ RC1 fwiw, will do another RC today and release tomorrow

[unbornchikken]

I'd appreciate if someone could take a look at this issue #877 before this release, because by my opinion this is a serious bug originating from 0.11.15, that makes debugging io.js applications a huge PITA.

[Ndrou]

@unbornchikken 👍

[mikeal]

@unbornchikken I'll make sure we talk about it today in the Tracing WG meeting but we don't hold up releases for stuff like this. But, we're releasing every week so once it is fixed it'll land in a new release quite soon :)

[unbornchikken]

Gonna take me a while to get used to that I don't have to wait for two years for a new release. :) Thanks.

[rvagg]

OK, no criticism of the heavy Markdown, and on thinking it through further -- if you want a cleaner list then just git log for yourself, a CHANGELOG should be more helpful! So in lieu of further feedback I'm pushing ahead with experimentation.

As per @aheckmann's suggestion, I'm trying commit grouping here and it's actually quite nice:

• [35ed79932c] - benchmark: add a few querystring benchmarks (Brian White) #847
• [c6fd2c5e95] - buffer: fix pool offset adjustment (Trevor Norris)
• [36a779560a] - buffer: expose internals on binding (Vladimir Kurchatkin) #770
• [e63b51793b] - crypto: fix to check ext method for shared lib (Shigeki Ohtsu) #800
• [9e05c8d2fc] - doc: remove outdated language on consensus (Emily Rose)
• [ed240f44f7] - doc: document 'ciphers' option of tls.connect (Roman Reiss) #845
• [0555b3c785] - doc: fix typo miliseconds -> milliseconds (jigsaw) #865
• [fc6507dd4e] - doc: add comma in README to increase clarity (Jimmy Hsu)
• [f0296933f8] - doc: correct it's to its in process (Charmander) #837
• [e81731ad18] - doc: add geek as collaborator (Wyatt Preul) #835
• [4ca7cca84a] - doc: grammar fix in smalloc (Debjeet Biswas) joyent/node#9164
• [30dca66958] - doc: fix code syntax (Dan Dascalescu) joyent/node#9198
• [8c1df7a8a8] - doc: use correct signature for assert() (Andrei Sedoi) joyent/node#9003
• [ba40942ad2] - doc: fix sentence grammar timers.markdown (Omer Wazir) #815
• [789ff959be] - doc: increase mark class contrast ratio (Omer Wazir) #824
• [122a1758d1] - doc: better font-smoothing for firefox (Jeremiah Senkpiel) #820
• [982b143ab3] - doc: disable font ligatures (Roman Reiss) #816
• [cb5560bd62] - doc: Close code span correctly (Omer Wazir) #814
• [c3c2fbdf83] - doc: change effect to affect in errors.md (Ryan Seys) #799
• [b620129715] - doc: add sam-github as collaborator (Sam Roberts) #791
• [e80f803298] - doc: remove Caine section from contributing guide (Michaël Zasso) #804
• [400d6e56f9] - doc: fix libuv link (Yosuke Furukawa) #803
• [15d156e3ec] - doc: fix wording in fs.appendFile (Rudolf Meijering) #801
• [dbf75924f1] - doc: update error links (Chris Dickinson) #793
• [7061669dba] - events: optimize adding and removing of listeners (Brian White) #785
• [630f636334] - events: move slow path to separate function too (Brian White) #785
• [ecef87177a] - fs: ensure nullCheck() callback is a function (cjihrig) #887
• [6a2b204bbc] - module: replace NativeModule.require (Herbert Vojčík) joyent/node#9201
• [9b6b05556f] - net: unref timer in parent sockets (Fedor Indutny) #891
• [cca8de6709] - net: remove use of arguments in Server constructor (cjihrig)
• [0cff0521c3] - net: throw on invalid socket timeouts (cjihrig) joyent/node#8884
• [b5f25a963c] - src: ensure that file descriptors 0-2 are valid (Ben Noordhuis) #875
• [a956791f69] - src: fix typo in error message (Ben Noordhuis) #875
• [fb28c91074] - src: fix add-on builds, partially revert 8aed9d66 (Ben Noordhuis) #868
• [4bb3184d8d] - src: reduce AsyncWrap memory footprint (Ben Noordhuis) #667
• [7e779b4593] - src: remove obsoleted queue.h header (Ben Noordhuis) #667
• [38dc0cd8f4] - src: switch from QUEUE to intrusive list (Ben Noordhuis) #667
• [58eb00c693] - src: add typesafe intrusive list (Ben Noordhuis) #667
• [8aed9d6610] - src: cleanup Isolate::GetCurrent() (Vladimir Kurchatkin) #807
• [7c22372303] - src: remove trailing whitespace (Vladimir Kurchatkin) #798
• [20f8e7f17a] - test: remove flaky test functionality (Rod Vagg) #812
• [30e340ad9d] - test: fix parallel/test-tls-getcipher (Roman Reiss) #853
• [d53b636d94] - test: verify fields in spawn{Sync} errors (cjihrig) #838
• [3b1b4de903] - test: Timeout#unref() does not return instance (Jan Schär) joyent/node#9171
• [becb4e980e] - test: distribute crypto tests into separate files (Brendan Ashworth) #827
• [77f35861d0] - (SEMVER-MINOR) tls: more secure defaults (Roman Reiss) #826
• [faa687b4be] - url: reslove urls with . and .. (Amir Saboury) #278

I might hold up release pending resolution of #894 for a few more hours (partly because I'm kind of busy right at this moment anyway!). If it's not resolved within the next 8 or so hours then I'll get the release out and just note that in the Known Issues section and push for a patch release ASAP.

[rvagg]

FYI this is with changelog-maker --group, there is also a --simple that strips out all of the Markdown cruft for easier terminal viewing.

[rvagg]

CHANGELOG.md header so far, unfortunately I can't find any other notable changes to mention here, does anybody else want to highlight things?

2015-02-20, Version 1.3.0, @rvagg

Notable changes

• url:
  • url.resolve('/path/to/file', '.') now returns /path/to/ with the trailing slash, url.resolve('/', '.') returns /. #278 (Amir Saboury)
• tls:
  • tls (and in turn https) now rely on a stronger default cipher suite which excludes the RC4 cipher. If you still want to use RC4, you have to specify your own ciphers suite. #826 (Roman Reiss)
• assert:

Known issues

• Surrogate pair in REPL can freeze terminal #690
• Not possible to build io.js as a static library #686
• process.send() is not synchronous as the docs suggest, a regression introduced in 1.0.2, see #760 and fix in #774 still pending resolution.

Commits

...