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

Create a checklist for MDN short surveys #17

Open
wants to merge 6 commits into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions short-survey-checklist.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
# Checklist for MDN short surveys

This document lists points that need to be checked before publishing an MDN short survey.

# Mandatory fields
Copy link
Member

Choose a reason for hiding this comment

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

I realize these comes from the MDN short survey process, but suggestions below to improve a bit from there

Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
# Mandatory fields
# Filing a survey request

- [ ] Topic: The topic of the survey
- [ ] Category: E.g. CSS, JavaScript, Accessibility, documentation
Copy link
Member

Choose a reason for hiding this comment

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

is it the category of the pages on which the survey will be shown? if so, that should be clarified

Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
- [ ] Category: E.g. CSS, JavaScript, Accessibility, documentation
- [ ] Areas of MDN where the survey should show: E.g. CSS, JavaScript, Accessibility

- [ ] Date: Time constraints on when the survey should be run (if any)
- [ ] Objective: What is the goal?
- [ ] Justification: How is it relevant/interesting to the MDN audience?
- [ ] Actions: Actions which will be taken based on the results
- [ ] Sampling rate: Suggested percentage of the MDN audience to be exposed to the survey. Default is 5%, if higher a clear motivation is needed.
- [ ] Questions: Suggested questions and answers
- [ ] Other: Any other information which is relevant.
Copy link
Member

Choose a reason for hiding this comment

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

Probably not "mandatory" :)


# Checking questions
- [ ] How should the questions be presented? Multiple choice, expanded list, etc
- [ ] Does any of the lists need to appear in random order?
- [ ] Do any of the items in a list need to appear in a specific order?
- [ ] Is there a free form field that needs to be excluded from random order?
- [ ] Is there a gating question that should disqualify people from taking the survey?