|
| 1 | +title: Notes from the Road |
| 2 | +author: tjfontaine |
| 3 | +date: Wed Jun 11 2014 09:00:00 GMT-0700 (PDT) |
| 4 | +status: publish |
| 5 | +category: Uncategorized |
| 6 | +slug: notes-from-the-road |
| 7 | + |
| 8 | +## Notes from the Road |
| 9 | + |
| 10 | +As Project Lead for Node.js, I was excited to have the opportunity to go on the |
| 11 | +road and bring production stories to all of our users. We've had amazing |
| 12 | +speakers and turn out in San Francisco, Seattle, Portland, Boston, and New |
| 13 | +York. But I wanted to make sure we reached more than just our coasts, so soon |
| 14 | +we'll be in |
| 15 | +[Minneapolis](http://www.joyent.com/noderoad/cities/minneapolis-6-17-2014) and |
| 16 | +I'll be returning to my home state of Ohio and doing an event in |
| 17 | +[Cincinnati](http://www.joyent.com/noderoad/cities/cincinnati-6-19-2014). The |
| 18 | +Node.js community is all over the world, and hopefully Node on the Road can |
| 19 | +reach as many of you as it can. Nominate your city to be a future stop on the |
| 20 | +Node.js on the Road series |
| 21 | +[here](http://www.joyent.com/noderoad/cities/suggest). |
| 22 | + |
| 23 | +These Node on the Road events are successful because of the incredible support |
| 24 | +from the community and the existing meetup organizations in their respective |
| 25 | +cities. But the biggest advantage is that the project gets to solicit feedback |
| 26 | +directly from our users about what is and isn't working for them in Node.js, |
| 27 | +what modules they're using, and where they need Node to do better. |
| 28 | + |
| 29 | +## Release schedules |
| 30 | + |
| 31 | +Some of the feedback we've received has been about the upgrade process for |
| 32 | +Node. Veteran Node.js alums will occasionally sit around campfires and tell the |
| 33 | +stories of when things would break every release, or how long they stayed on |
| 34 | +0.4 before upgrading to 0.6. Some production companies are still out there |
| 35 | +running on 0.8 afraid to make the jump to 0.10. While other companies advise |
| 36 | +people to avoid upgrading to a new release of a Node version until the patch |
| 37 | +number hits double digits. It's those sorts of stories that make it important |
| 38 | +for us to get the release for 0.12 right, from the get go. |
| 39 | + |
| 40 | +Node is in a fantastic place right now, it's maturing quickly and finding its |
| 41 | +footing in new environments with new users and new use cases. The expectation |
| 42 | +for Node is getting higher each day with every release. There are multiple |
| 43 | +interests at stake, keeping Node lean, keeping it up to date with languages and |
| 44 | +standards, keeping it fast, and balanced with keeping it stable such that we |
| 45 | +don't upset the adoption rate. That means Node needs to make the right choices |
| 46 | +that balance the needs of all of our users without closing the doors to others. |
| 47 | + |
| 48 | +All of these conversations are helping to shape the release process going |
| 49 | +forward, and helping to scope just what does go into a release and how fast |
| 50 | +people want to see those happen. In fact something we've been considering is |
| 51 | +eliminating the confusion around our Stable/Unstable branches, and instead |
| 52 | +moving to releases that are always stable. But it's important that the features |
| 53 | +and changes that go into a release are shaped by user feedback, which is why |
| 54 | +events like Node on the Road are vital. |
| 55 | + |
| 56 | +## Better Documentation |
| 57 | + |
| 58 | +Another key piece of feedback has consistently been around our documentation. |
| 59 | +Users need us to clean up our API reference documentation, there are lots of |
| 60 | +undocumented and under-documented methods and properties that are being used or |
| 61 | +should be used. Node needs to include what errors may be delivered as part of |
| 62 | +the operation of your application, as well as what methods will throw and under |
| 63 | +what circumstances. |
| 64 | + |
| 65 | +But mostly users are looking for more general purpose documentation that can |
| 66 | +help both new and veteran Node.js users be more productive with Node. And the |
| 67 | +people who are most equipped to provide that documentation are the users |
| 68 | +themselves who've already been successful. |
| 69 | + |
| 70 | +## Easier Contribution |
| 71 | + |
| 72 | +Aside from soliciting feedback from users of Node.js and bringing production |
| 73 | +stories to our users, Node on the Road has also been about highlighting the |
| 74 | +various ways you as a member of the community can contribute. There are many |
| 75 | +ways you can contribute from meetups and conferences, to publishing modules, to |
| 76 | +finding issues in modules or core, to fixing issues in modules or core, or even |
| 77 | +adding features to modules or core. Where ever you are passionate about Node.js |
| 78 | +there are ways you can contribute back to Node. |
| 79 | + |
| 80 | +Node.js has inherited many things from our largest dependency V8, we've adopted |
| 81 | +their build system GYP, we use their test runner (which is unfortunately in |
| 82 | +python), and when we were structuring the project we brought along the |
| 83 | +Contributor License Agreement (CLA) that Google uses to manage contributions |
| 84 | +for Chromium and V8. The CLA is there as a way for a project to audit itself |
| 85 | +and to give itself the opportunity to relicense itself in the future if |
| 86 | +necessary. Node.js though is distributed under the venerable |
| 87 | +[MIT](http://opensource.org/licenses/MIT) license, and that's not going to |
| 88 | +change. The MIT license is one of the most permissible open source licenses out |
| 89 | +there, and has fostered a ton of development with Node.js and we want that to |
| 90 | +continue. |
| 91 | + |
| 92 | +In an effort to make it easier for users to contribute to Node.js the project |
| 93 | +has decided to lift the requirement of signing the CLA before contributions are |
| 94 | +eligible for integration. Having to sign the CLA could at times be a stumbling |
| 95 | +block for a contribution. It could involve a long conversation with your legal |
| 96 | +department to ultimately contribute typo corrections. |
| 97 | + |
| 98 | +I'm excited to see what contributions will be coming from the community in the |
| 99 | +future, excited to see where our users take Node.js, and excited to be |
| 100 | +participating with all of you on this project. |
0 commit comments