This task involves the work of implementing an API that would enable the configuration values governing how "Add a link" gets presented in the newcomer homepage (MediaWiki:GrowthExperimentsSuggestedEdits.json) be automatically mirrored within the configuration values governing how the "Add a link" suggestion gets presented within Suggestion Mode.
To enable the above, the Editing Team will implement a new API that will:
- Listen for changes to MediaWiki:GrowthExperimentsSuggestedEdits.json
- Update to MediaWiki:Editcheck-config.json to reflect relevant changes in MediaWiki:GrowthExperimentsSuggestedEdits.json
Requirements
| MediaWiki:GrowthExperimentsSuggestedEdits.json | Mirror in MediaWiki:Editcheck-config.json? | MediaWiki:Editcheck-config.json equivalent | Notes |
|---|---|---|---|
| This task is disabled | TBD | showAsSuggestion: false | |
| Articles containing templates defined here will not be shown to users as tasks for this task type | ✅ Yes | lacksTemplate | |
| Articles containing categories defined here will not be shown to users as tasks for this task type | ✅ Yes | notInCategory | |
| Destination page for learning more about add link task type | ❌ Not now | N/A | Links shown within Suggestion Cards are defined in interface messages not within the config file. Although, importing could be supported if we deemed it necessary. |
| Maximum number of links to show per task | ❌ No | N/A | Per T421968#11801073, if/when we come to learn too many links are being suggested within articles, we'll seek to increase the predictionThreshold |
| List of excluded sections from the Add link task | ✅ Yes | ignoreSections | |
| The maximum number of "Add a link" suggested tasks a newcomer can complete daily | ❌ Not now | N/A | We assume the risk of someone completing a lot of link suggestions using Suggestion Mode to be low enough to omit this ceiling for now |
| Weight of underlinked articles | ❌ No | N/A | This value is specific to the newcomer homepage, per T421968#11795735 |
| Minimum required link score | ✅ Yes | predictionThreshold | |
| Stop suggesting "Add a link" tasks based on newcomers' total edits | ❌ Not now | N/A | Suggestions don't currently respect account-based limits; this functionality will be implemented in TICKET; timing TBD |
Done
- Editing Team populates the Requirements section with details about the proposed API
- Growth Team (@KStoller-WMF + @Michael) review proposed API
- @ppelberg review https://www.mediawiki.org/wiki/Growth/Personalized_first_day/Structured_tasks/Community_feedback
- Editing Team updates Requirements to include Growth Team feedback
- Editing Team implements API