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:
1. Listen for changes to `MediaWiki:GrowthExperimentsSuggestedEdits.json`
2. Update to `MediaWiki:Editcheck-config.json` to reflect //relevant// changes in `MediaWiki:GrowthExperimentsSuggestedEdits.json`
NOTE: The API this ticket will introduce will be relevant now //and// in a potential future wherein EditCheck-config.json is migrated to the Community Configuration extension (T372927)
=== 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
- [x] Editing Team populates the `Requirements` section with details about the proposed API
- [ ] Growth Team (@KStoller-WMF + @Michael) review proposed API
- [ ] Editing Team updates `Requirements` to include Growth Team feedback
- [ ] Editing Team implements API