Depending on the list of wikis to process, we might need to also implement T345562: Generate excludedSections list for wikis missing in wiki_sections.jsonl to be able to generate excluded sections for new(ish) wikis.

In Backlog refinement, we agreed that:

• @KStoller-WMF will ensure we have a final list of wikis (in the Add Link scaling meeting, we decided to start with "wikis that didn’t have v1 model support")
• @Urbanecm_WMF will sync with @OKarakaya-WMF regarding excluded sections need

For Monday Nov 24 issue:

Add a link will be deployed to Chinese, Japanese, & Urdu Wikipedia on December 2,using a new model for links suggestions. This is the first time these communities will have access to Add a link. These communities have been contacted, in order to configure this feature through Community Configuration.

I'll message the wikis on the 19th and document it in this task description. This link in Tech News is to increase the visibility of these discussions.

Verifying the linkrecommendation service is able to produce recommendations:

urbanecm@wmf3345 ~ % curl -s 'https://api.wikimedia.org/service/linkrecommendation/v1/linkrecommendations/wikipedia/zh/%E5%B8%83%E6%8B%89%E6%A0%BC' | json_pp | head -n 5 
{
   "links" : [
      {
         "context_after" : "名城。",
         "context_before" : "万。\n\n布拉格是一座",
urbanecm@wmf3345 ~ % curl -s 'https://api.wikimedia.org/service/linkrecommendation/v1/linkrecommendations/wikipedia/ja/Prague' | json_pp | head -n 5 
{
   "links" : [
      {
         "context_after" : ",そのうちやる音,C",
         "context_before" : "eCityClub,",
urbanecm@wmf3345 ~ % curl -s 'https://api.wikimedia.org/service/linkrecommendation/v1/linkrecommendations/wikipedia/ur/%D9%88%D9%B9%D9%86%DB%8C' | json_pp | head -n 5
{
   "links" : [
      {
         "context_after" : " ہے۔ یہ ",
         "context_before" : " بازار کا ",
urbanecm@wmf3345 ~ %

All successful. It took me longer for urwiki to find a page with at least one recommendation, but we will see about the task pool later.

Change #1206948 had a related patch set uploaded (by Urbanecm; author: Urbanecm):

[operations/mediawiki-config@master] [Growth] Enable Add Link task pool generation for 3 wikis

https://gerrit.wikimedia.org/r/1206948

https://wikitech.wikimedia.org/wiki/Add_Link#Enabling_on_a_new_wiki is heavily out of date. There is pretty much not a single point that is up to date. In addition to that, the process it describes is unnecessarily complicated; we should just simplify it instead. I'll fill a task for that.

First step is adding excluded sections:

[urbanecm@deploy2002 ~]$ WIKI=jawiki
[urbanecm@deploy2002 ~]$ PHAB=T407818
[urbanecm@deploy2002 ~]$ jq "select(.wiki==\"$WIKI\" and .probability > 0.25) | .section" wiki_sections.jsonl | jq --slurp --compact-output "unique" | mwscript-k8s -f -- CommunityConfiguration:ChangeWikiConfig.php --wiki=$WIKI --summary "machine-generated configuration for excluding sections from link recommendations ([[phab:$PHAB]]), feel free to improve" GrowthSuggestedEdits link_recommendation.excludedSections "`cat`"
ℹ️ Your job will run on PHP 8.3 (T405955). If you encounter a compatibility issue, you can use --php_version 8.1 to explicitly select 8.1.
⏳ Starting CommunityConfiguration:ChangeWikiConfig.php on Kubernetes as job mw-script.codfw.rs81nlh7 ...
🚀 Job is running.
📜 Streaming logs:
Saved!
[urbanecm@deploy2002 ~]$

(I run into a problem running this script, cf. T410451).

Next step is enabling wgGENewcomerTasksLinkRecommendationsEnabled, which would enable the Community Configuration bits (as well as start the population of the task pool). I'm not sure when that can happen, I asked in Slack and I'll wait @Trizek-WMF's confirmation. It would be helpful if we could start sooner than Nov 20, so that I could verify everything works from the technical perspective.

If needed, it is possible to deploy the feature in "forcefully disabled" mode (see screenshot), which would make it available in CC, but not enableable by the admins.

In T407818#11385945, @Urbanecm_WMF wrote:

https://wikitech.wikimedia.org/wiki/Add_Link#Enabling_on_a_new_wiki is heavily out of date. There is pretty much not a single point that is up to date. In addition to that, the process it describes is unnecessarily complicated; we should just simplify it instead. I'll fill a task for that.

Done: T410457: Simplify Add Link deployment process

All tasks I filled based on the work I did here so far:

• T410451: mwscript-k8s returns a confusing error message when --attach is used and the script cannot be attached to
• T410457: Simplify Add Link deployment process
• T407818: Add a Link: Rollout "Add a Link" Structured Task to Chinese, Japanese, & Urdu Wikipedias
• T410459: CommunityConfiguration has a hack to truly disable fields via onCommunityConfigurationSchemaBeforeEditor

Apologies for the work-done-to-tasks-created ratio being so high! :)

Change #1206948 merged by jenkins-bot:

[operations/mediawiki-config@master] [Growth] Enable Add Link task pool generation for 3 wikis

https://gerrit.wikimedia.org/r/1206948

Mentioned in SAL (#wikimedia-operations) [2025-11-24T15:48:47Z] <urbanecm@deploy2002> Started scap sync-world: Backport for [[gerrit:1206948|[Growth] Enable Add Link task pool generation for 3 wikis (T407818)]]

Mentioned in SAL (#wikimedia-operations) [2025-11-24T15:53:54Z] <urbanecm@deploy2002> urbanecm: Backport for [[gerrit:1206948|[Growth] Enable Add Link task pool generation for 3 wikis (T407818)]] synced to the testservers (see https://wikitech.wikimedia.org/wiki/Mwdebug). Changes can now be verified there.

Mentioned in SAL (#wikimedia-operations) [2025-11-24T16:00:51Z] <urbanecm@deploy2002> Finished scap sync-world: Backport for [[gerrit:1206948|[Growth] Enable Add Link task pool generation for 3 wikis (T407818)]] (duration: 12m 04s)

Mentioned in SAL (#wikimedia-operations) [2025-11-24T16:23:18Z] <urbanecm> Delete job/growthexperiments-refreshlinkrecommendations-s2-29399967 and job/growthexperiments-refreshlinkrecommendations-s3-29399607 (T407818)

This does not seem to have actually been sent in the Tech News issue it was supposed to be sent in.

In T407818#11411752, @Pppery wrote:

This does not seem to have actually been sent in the Tech News issue it was supposed to be sent in.

It is, based on T407448.

@Urbanecm_WMF let me know when you plan to deploy. We are good to go.

In T407818#11420852, @Trizek-WMF wrote:

@Urbanecm_WMF let me know when you plan to deploy. We are good to go.

Yay! In that case, I'll roll it out tomorrow, based on the plan in the task description.

Change #1213988 had a related patch set uploaded (by Urbanecm; author: Urbanecm):

[operations/mediawiki-config@master] [Growth] Enable Add Link for 3 wikis

https://gerrit.wikimedia.org/r/1213988

Change #1213988 merged by jenkins-bot:

[operations/mediawiki-config@master] [Growth] Enable Add Link for 3 wikis

https://gerrit.wikimedia.org/r/1213988

Mentioned in SAL (#wikimedia-operations) [2025-12-02T14:39:42Z] <urbanecm@deploy2002> Started scap sync-world: Backport for [[gerrit:1213988|[Growth] Enable Add Link for 3 wikis (T407818)]]

Mentioned in SAL (#wikimedia-operations) [2025-12-02T14:41:52Z] <urbanecm@deploy2002> urbanecm: Backport for [[gerrit:1213988|[Growth] Enable Add Link for 3 wikis (T407818)]] synced to the testservers (see https://wikitech.wikimedia.org/wiki/Mwdebug). Changes can now be verified there.

Mentioned in SAL (#wikimedia-operations) [2025-12-02T14:47:28Z] <urbanecm@deploy2002> Finished scap sync-world: Backport for [[gerrit:1213988|[Growth] Enable Add Link for 3 wikis (T407818)]] (duration: 07m 46s)

Links are added in at Japanese and Chinese, while Urdu remains blank at the moment (this wiki is much smaller).

Checked - all looks as expected. Still urwiki doesn't have SE edits as @Trizek-WMF mentioned in https://phabricator.wikimedia.org/T407818#11425152

@KStoller-WMF - I looked at the following specs - do the doc pages still need to be updated?

• review if https://wikitech.wikimedia.org/wiki/Add_Link#Enabling_on_a_new_wiki is still up-to-date and update as needed
• add an update to https://wikitech.wikimedia.org/wiki/Add_Link#Updates

Moving it out of QA column to indicate that QA work is done.

In T407818#11435135, @Etonkovidova wrote:

Checked - all looks as expected. Still urwiki doesn't have SE edits as @Trizek-WMF mentioned in https://phabricator.wikimedia.org/T407818#11425152

Tada, urwiki has one "Add a Link" edit now!

@KStoller-WMF - I looked at the following specs - do the doc pages still need to be updated?

• review if https://wikitech.wikimedia.org/wiki/Add_Link#Enabling_on_a_new_wiki is still up-to-date and update as needed
• add an update to https://wikitech.wikimedia.org/wiki/Add_Link#Updates

@Urbanecm_WMF can you work on updating documentation, or should I break that into a subtask?

Added an update. Updating the documentation is T410457: Simplify Add Link deployment process (and subtasks).