Skip to content

doc: add guide and answers to FAQs for first-time contributors#63685

Merged
nodejs-github-bot merged 6 commits into
nodejs:mainfrom
joyeecheung:first-time
Jun 30, 2026
Merged

doc: add guide and answers to FAQs for first-time contributors#63685
nodejs-github-bot merged 6 commits into
nodejs:mainfrom
joyeecheung:first-time

Conversation

@joyeecheung

Copy link
Copy Markdown
Member

This guide tries to capture some recurring issues I see (with suggestions that other collaborators seem to agree with in offline discussions) and address FAQs I constantly get when mentoring different new contributors.

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Review requested:

  • @nodejs/tsc

@nodejs-github-bot nodejs-github-bot added doc Issues and PRs related to the documentations. meta Issues and PRs related to the general management of the project. labels May 31, 2026
@joyeecheung joyeecheung force-pushed the first-time branch 2 times, most recently from bfc12f2 to 5a9bf7c Compare May 31, 2026 21:23
Comment thread doc/contributing/first-contributions.md Outdated
Comment thread doc/contributing/first-contributions.md
Comment thread doc/contributing/first-contributions.md
@Renegade334

Copy link
Copy Markdown
Member

Seemingly one of the more common tropes at the moment is opening PRs against issues with an existing open PR. I couldn't see any specific mention of this in our existing guidance, but this seems like a good place to discourage it.

@MikeMcC399

Copy link
Copy Markdown
Contributor

As a new contributor I was confused by not being able to access Jenkins logs and I thought I must be missing some privileges. As I later found out, that was due to being locked out because a security release was being prepared. Perhaps that should be mentioned somewhere? Maybe not just in the FAQs for first-time contributors, but also in the regular PR submission guidelines?

Comment thread doc/contributing/first-contributions.md Outdated
Comment thread doc/contributing/first-contributions.md
Comment thread doc/contributing/first-contributions.md Outdated
@joyeecheung

Copy link
Copy Markdown
Member Author

@aduh95 @LiviaMedeiros @MikeMcC399 @trivikr @MoLow I think I addressed all the comments. Can you take a look again? Thanks!

Comment thread doc/contributing/first-contributions.md Outdated
Comment thread doc/contributing/first-contributions.md Outdated
Comment thread doc/contributing/first-contributions.md Outdated

@MikeMcC399 MikeMcC399 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

This is a great document for new contributors! I wish it had been available when I started!

I just made some minor text editing suggestions, otherwise it looks very good to me.

Co-authored-by: Mike McCready <66998419+MikeMcC399@users.noreply.github.com>
@joyeecheung joyeecheung added the review wanted PRs that need reviews. label Jun 29, 2026
@joyeecheung

Copy link
Copy Markdown
Member Author

Going to land this by the end of today if there is no blocking concerns.

@joyeecheung joyeecheung added commit-queue Add this label to land a pull request using GitHub Actions. and removed review wanted PRs that need reviews. labels Jun 30, 2026
@nodejs-github-bot nodejs-github-bot removed the commit-queue Add this label to land a pull request using GitHub Actions. label Jun 30, 2026
@nodejs-github-bot nodejs-github-bot merged commit 457fa67 into nodejs:main Jun 30, 2026
24 of 25 checks passed
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Landed in 457fa67

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

doc Issues and PRs related to the documentations. meta Issues and PRs related to the general management of the project.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

9 participants