-
Notifications
You must be signed in to change notification settings - Fork 97
[WIP] docs: Add VALUES.md #15
Changes from all commits
877cd13
7b7820d
4833e9a
4fec404
87e115a
935c330
d130fe8
c8c16d5
81cf687
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,66 @@ | ||
# Ayo.js Community Values | ||
|
||
Ayo.js is about the people that help make it happen. It's a project aimed at | ||
creating a new foundation of project governance and management that brings | ||
**humans** and their concerns front and center. | ||
|
||
You can pronounce it however you want: be it “ey-yo”, “I-oh”, or “Awooooo” — the | ||
Ayo.js project strives to create an environment where you can feel at home and | ||
focus on your contributions to this nice shared space that we all benefit from. | ||
|
||
## Ayo.js is more than the code in its repository. | ||
|
||
Documentation, long-term support, translations and localizations, | ||
package management, libuv, V8 and Chakra, builds/ops, testing and its | ||
infrastructure, hardware and IoT, Android, streams, community events, | ||
facilitation, moderation and education. These and more are all concerns that | ||
can be handled separately and by members who might be much better qualified | ||
for these individual tasks than a central decision body. | ||
|
||
Ayo.js will go further than Node.js did in spreading responsibility across | ||
the project, so everyone can focus and specialize better than before. | ||
Contributors should be able to organize and manage their own subprojects | ||
in a way that is effective and efficient for their unique needs. | ||
|
||
## Humans are more important than red tape. | ||
|
||
If governance policy is not serving the values set forth here, that governance | ||
policy should change with the required agility. Following the governance policy | ||
to the letter will not take precedence over staying true to our stated values or | ||
the well-being of our humans. | ||
|
||
## Humans are more important than APIs and Benchmarks. | ||
|
||
Technical discussions are difficult, especially in large communities with | ||
members with all sorts of perspectives. Contributors are bound to find themselves in | ||
situations with no clear consensus, with new concerns being brought up | ||
on a regular basis, and things that might seem insignificant in other | ||
contexts suddenly exploding. | ||
|
||
The Ayo.js project’s perspective is that when such things happen, it often takes | ||
a toll on the well-being of the members participating, at times preventing | ||
repeated contributions or precluding new contributors outright. It also | ||
recognizes that the difference between individual choices is less important than | ||
the ability to come to an appropriate technical decision. | ||
|
||
Projects change, evolve, and find themselves dealing with new concerns all the | ||
time. In all technical matters, Ayo.js will take into account that in the end, | ||
it is the people making, implementing, and maintaining that matter most, not the | ||
decisions themselves. It’s okay for code to be imperfect. | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Uhhh. I'd prefer code that ran faster and was optimized. People shouldn't feel ousted because their pull was denied because it had garbage code in it. If this fork turns into a bloated mess, people won't use it. 🤷 There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. .....this isn't about ousting anyone, and I have not the remotest clue where you got that. This is about not dragging on technical conversations to the point of diminishing returns, and framing them in as constructive a way as possible. Perfect is the enemy of good. |
||
|
||
## Humans are more important than corporations. | ||
|
||
All sorts of corporations and other organizations around the world use and | ||
benefit from the software underlying Ayo.js, and many contributors, in fact, may | ||
be directly compensated by them for their efforts on the project. But this can | ||
often turn into such direct reliance on corporations that they can essentially | ||
seize control of a project — or struggle for power over it while individual | ||
contributors are left wondering if they can ever influence the project | ||
themselves. | ||
|
||
Ayo.js will explore new structures and framings for corporate relationships | ||
in such a way that its individual humans, not the corporations that employ them, | ||
are ultimately still the ones determining the direction of the project. | ||
Ayo.js should be a space where independent contributors, freelancers, hobbyists, | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Can we standardize on "will" here as well? Or "is" if we feel as if we're already there. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I like the strength, but I feel weird about changing it in form from a guideline to an affirmation. If, for whatever reason, we fail to meet that goal in some way, we don't want to consider the project a failure, we just want amend the project in a way that serves these values. To me, "will" serves the idea of failure and "should" serves the idea of aspiration, of accepting our imperfections and striving to improve ourselves. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Fair! Especially in a document discussing vision I prefer to use the more concrete "will" as it clearly shows our conviction. Also, if we fail, is that a bad thing? Surely criteria that we set out to achieve and fail on can serve for very good points of discussion when we are evaluating how and where we want to improve. |
||
and students all feel like they hold the same footing as corporate employees | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. "all feel like they hold" => "all feel like they can hold" feels more accurate, as there will still be election processes and division of power I imagine. |
||
at all levels of the project. | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Do y'all think it'd be worth adding another heading expanding on our desire to create a welcoming space for aspiring contributors? The other values work to that end, but I believe it's worth strongly stating as its own explicit goal past the mention beyond the mention here and in the heading. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Happy to take suggestions for wording if you have any :) There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I'll think on it! I'm about to head to bed but I'll mull it over and if nobody's beat me to it I'll take a crack at it tomorrow evening. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. After mulling it over, I think this is a natural extension of the other elements of the statements here. Others should feel free to add this if they think otherwise, but I'm happy with this where it is, and I'm feeling like I'd rather make an addition later than leave this in limbo longer than it needs to be. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Newcomers may have a bit more trouble finding space than existing folks, so maybe it is worth it? Or perhaps only in the other guidelines, unnecessary as an extra stated core value as this already covers that? |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Headings don't usually have full stops.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This was an intentional decision I made when I wrote the initial draft to make these stand out as definitive statements in addition to headings. I'm fine with changing that if it doesn't work.