==== User Story:
As a mentor,
I want to offer feedback and encouragement to newcomers **and I want to customize those settings,**
Because then newcomers are more likely to continue contributing.
==== Background:
- [[ https://docs.google.com/presentation/d/1L6DOn6nY8aTR0GgJNSYML4E4H4v0Za1E6ji3WsA7X9M/edit#slide=id.g8abf83970e_0_0 | Research ]] shows that praise and encouragement from other users increases newcomer retention.
- Growth documentation: [[ https://www.mediawiki.org/wiki/Growth/Positive_reinforcement | Mediawiki overview of Positive Reinforcement project ]].
==== Designs
[[ https://www.figma.com/file/fOa1x7hw6EM9VnaMJv7vib/Positive-reinforcement?node-id=3231%3A111001&t=oyAvHs58GjamfX80-0 | Figma Designs: Personalized Praise Settings ]]
{F35845335}
==== Community Configuration:
Mentors can set their own preferences, but we need reasonable defaults set. And what is reasonable will vary considerably by wiki (depending on the ratio of newcomers to mentors and other factors), so we should allow wikis to set their own default via community configuration.
**Setting defaults should be configurable by wiki via Special:EditGrowthConfig, at the bottom of the Mentorship section. **
> **Personalized praise: **
> Should the Mentor dashboard include a module to surface mentees who are editing successfully?
> [x] Enabled
>
> How often should Mentors receive notifications to remind them to send encouragement to mentees who are editing successfully?
> [] Never
> [] Monthly
> [x] Weekly
> [] Daily
> [] Immediately
>
> To qualify a newcomer for personal encouragement from their mentor, they should have:
> - At least _____ edits within _____.
>
>
Based on data gathered in [[ https://phabricator.wikimedia.org/T323136#8436490 | this task ]], we should set these as the initial baselines:
- **Weekly **
- At least **8 edits** within **1 week**
====Questions:
[] How can we ensure we don't suggest newcomers whose edits are being reverted? Should we only include users with <2 reverts within that same time period or some other "quality gate" here? Or should we only consider unreverted edits in the edit count? Or is it worth bringing these active but struggling newcomers to the attention of their Mentor?
[] On wikis that don't have a large enough Mentor group to cover all newcomers, how can we ensure that we aren't suggesting Mentees who don't know they have a Mentor?
[] Should we have wikis customize the default message?
==== Acceptance Criteria:
Given I'm a Mentor and I visit my Mentor Dashboard,
When I have praiseworthy mentees,
Then I can adjust the following settings:
- frequency of notifications: Immediately, Daily, Weekly, Monthly
- default message subject
- default message
- metric that triggers adding mentee to "praiseworthy" list
Given I'm an Admin or privileged user,
When I want to adjust community configuration
Then I can adjust the following:
- frequency of notifications: Immediately, Daily, Weekly, Monthly
- metric that triggers adding mentee to "praiseworthy" list