Skip to content
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

doc: add collaborator guide #273

Closed
wants to merge 2 commits into from

Conversation

mmarchini
Copy link
Contributor

llnode has been unofficially following the Node.js Collaborator Guide
wrt Approving and Landing PRs policy. On the downside, these policies
were written for a large project with 100+ collaborators and dozens of
active collaborators daily. llnode has only a few collaborators, and
some policies slow the project quite a bit.

This commit adds COLLABORATOR_GUIDE.md with a link to Node.js
Collaborator Guide, so we'll start to follow these guidelines
officially. It also adds one exception to ensure the project can move
forward with a limited number of collaborators.

Fixes: #242

llnode has been unofficially following the Node.js Collaborator Guide
wrt Approving and Landing PRs policy. On the downside, these policies
were written for a large project with 100+ collaborators and dozens of
active collaborators daily. llnode has only a few collaborators, and
some policies slow the project quite a bit.

This commit adds COLLABORATOR_GUIDE.md with a link to Node.js
Collaborator Guide, so we'll start to follow these guidelines
officially. It also adds one exception to ensure the project can move
forward with a limited number of collaborators.

Fixes: nodejs#242
@mmarchini
Copy link
Contributor Author

cc @nodejs/diagnostics @nodejs/post-mortem @nodejs/llnode

@codecov-io
Copy link

codecov-io commented Feb 26, 2019

Codecov Report

Merging #273 into master will increase coverage by 1.26%.
The diff coverage is n/a.

Impacted file tree graph

@@            Coverage Diff             @@
##           master     #273      +/-   ##
==========================================
+ Coverage   79.96%   81.23%   +1.26%     
==========================================
  Files          34       34              
  Lines        4292     4369      +77     
==========================================
+ Hits         3432     3549     +117     
+ Misses        860      820      -40
Impacted Files Coverage Δ
src/settings.cc 78.94% <0%> (-21.06%) ⬇️
src/llnode.cc 73.12% <0%> (-4.19%) ⬇️
test/plugin/inspect-test.js 92.49% <0%> (ø) ⬆️
src/llnode.h 50% <0%> (ø) ⬆️
src/llv8.cc 76.11% <0%> (+0.06%) ⬆️
src/llv8-inl.h 93.54% <0%> (+0.26%) ⬆️
test/plugin/scan-test.js 98.91% <0%> (+0.36%) ⬆️
src/llv8-constants.cc 86.62% <0%> (+1%) ⬆️
src/llv8-constants.h 98.43% <0%> (+1.56%) ⬆️
src/llv8.h 97.56% <0%> (+2.43%) ⬆️
... and 3 more

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update ea06ef5...a6e3e75. Read the comment docs.

with the following exception:

llnode Collaborators are allowed to approve their own Pull Requests if it has
been opened for at least 7 days and there was no reviews from other
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't really like this idea. However, if this does land, please add text about requiring a passing CI run.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is covered by the Node.js Collaborators Guide, but I can make it explicit here too.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe just say something to the effect of "All other landing criteria still have to be met even if its self-approved." rather than repeating the criteria.

Is it really that hard to get approval on PRs here? llnode is pretty important now that its almost our default http parser, I'd hope it gets more attention than that. Could the exception be removed, and the issue of lack of active collabs be brought up to the TSC level, or equivalent?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe just say something to the effect of "All other landing criteria still have to be met even if its self-approved." rather than repeating the criteria.

I like that. I'll make the change.

Is it really that hard to get approval on PRs here?

Medium and large changes tend to take a month or more to get reviewed.

llnode is pretty important now that its almost our default http parser, I'd hope it gets more attention than that.

I think you're referring to https://github.com/nodejs/llhttp. llnode is unrelated to HTTP parsing.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, I absolutely misread, sorry!

@mmarchini
Copy link
Contributor Author

I just did a walkthrough all PRs we landed since the last Diagnostics Summit, and most of them were reviewed within a week or so. Based on that I think the exception is unnecessary and I'd rather keep the review policy we've been using so far.

@mmarchini
Copy link
Contributor Author

Superseded by #275.

@mmarchini mmarchini closed this Mar 5, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

5 participants