-
Notifications
You must be signed in to change notification settings - Fork 29.6k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
assemble a changelog for 1.0.0 #305
assemble a changelog for 1.0.0 #305
Comments
I suggest that you focus here on the differences between Node.js and io.js (prop. 3), and link to the Node repository for the changelog since 0.10. That's a good way to show that you are compatible with Node.js, and that you only add your layer on top of Node. That's also what I, as a Node user, would like to see first on your site. |
I would expect a changelog since Node.js 0.10.35. |
I've said this a few times around various parts of the io.js projects, but I think we could take some inspiration from https://developer.mozilla.org/en-US/Firefox/Releases -- especially how they list future versions along side stable ones. (The one thing I don't like is their table layout which does nothing to indicate stable/not/release-dates.) But it would be nice to start laying out what is (expected to be) coming on each scheduled release, especially with the recent ES6 feature concerns, etc. This can help communicate to the community to begin playing with feature flags, unstable APIs, etc. and provide feedback. What is also nice in their documentation is knowing when previously unstable/flagged things are getting promoted, say in the "February 2015" release. Anyway, long story short, once in the web project we can get more of a build process/design structure in place, I'd be happy to help start laying this out. First thing's first -- getting the core content together. Perhaps somebody can start the v1.0 changelog in the wiki and PR that content to master once some rounds of edits go through? |
Agree 100% with @fzaninotto. |
Has anyone been working on this yet? |
no |
working in #339 |
We need to decide what the changelog contains and who does he work of putting it together.
The problem is of course that we have a whole community used to 0.10 and we're a very long way from there now. Do we just link to the joyent/node wiki page on the differences and let people figure it out? Perhaps er just limit ourselves to broad themes?
I'd love for someone to step up and craft an artisnal changelog for this release, but if nobody does I'll try and find a spare moment to churn something out.
Then there's the matter of some kind of release announcement coupled with this ...
The text was updated successfully, but these errors were encountered: