Skip to content
This repository was archived by the owner on Mar 25, 2018. It is now read-only.

Commit 43c0f01

Browse files
tjfontainefitzage
authored andcommitted
blog: notes from the road
1 parent e70519f commit 43c0f01

File tree

4 files changed

+100
-200
lines changed

4 files changed

+100
-200
lines changed

CONTRIBUTING.md

-6
Original file line numberDiff line numberDiff line change
@@ -87,9 +87,3 @@ Pull requests are usually reviewed within a few days. If there are comments
8787
to address, apply your changes in a separate commit and push that to your
8888
feature branch. Post a comment in the pull request afterwards; GitHub does
8989
not send out notifications when you add commits.
90-
91-
92-
### CONTRIBUTOR LICENSE AGREEMENT
93-
94-
Please visit http://nodejs.org/cla.html and sign the Contributor License
95-
Agreement. You only need to do that once.

Makefile

-1
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,6 @@ doc_images = $(addprefix out/,$(wildcard doc/images/* doc/*.jpg doc/*.png))
1717
website_files = \
1818
out/doc/index.html \
1919
out/doc/v0.4_announcement.html \
20-
out/doc/cla.html \
2120
out/doc/sh_main.js \
2221
out/doc/sh_javascript.min.js \
2322
out/doc/sh_vim-dark.css \
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,100 @@
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.

doc/cla.html

-193
This file was deleted.

0 commit comments

Comments
 (0)