nodejs / nodejs/next-10

Document the survey process

Open
#274 0 comments 3 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
No language data
Stars
550
Forks
31
Avg merge
4h 27m
Merged PRs (30d)
1

Description

We would like to formalize the process of creating the next-10 survey for Node.js.
The main issue is that we didnt define clearly a deadline after which the survey should not be modified.
My proposal is to document this process so that:

  • One champion opens the PR with the question copy pasted from the previous
  • We decide a deadline where the PR gets merged and questions cannot be added/removed (unless a reason important enough at discretion of the champion)
  • Collaborators and TSC review the questions, ask for changes etc... and approve
  • PR cannot be merged with changes requested, needs approval
  • A test-survey is then created to make sure there are no typos, errors on the platforms used on the survey etc...
  • After x days the survey goes live
  • After x days the survey is closed

@kyliewd will help us to define guidelines on how to prepare a survey, (lenght, open questions etc...)

ping @nodejs/next-10

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the previous next-10 survey and any existing guidance for creating it. Document the champion, review and approval steps, deadlines for changes, test-survey checks, and launch and closing timing; done means the process is written clearly enough for collaborators and the TSC to follow.

Written by the indexing model from the issue text.

Assessment

Tech stack
node.js
Domain
documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.