構造化された議論/廃止予定

This page is a translated version of the page Structured Discussions/Deprecation and the translation is 2% complete.

Structured Discussions (SD - Flow) is used on a few wikis. This extension is not maintained. DiscussionTools (DT) is the default discussion system on wikis now.

The Growth team (SD maintainers) and the Editing team (DT maintainers) have started thinking about how to deprecate Structured Discussions (and possibly LiquidThreads) and replace them with DiscussionTools.

Structured Discussions are a complex piece of software that generates a lot of maintenance issues. Estimating the work required to adapt Structured Discussions to the IP Editing: Privacy Enhancement and Abuse Mitigation project revealed a very significant workload. In view of all these challenges, the decision was taken to inform the communities of the future deprecation of Structured Discussions.

The idea is to encourage communities to switch active Structured Discussions tools to the DiscussionTools talk page format. Then, the Structured Discussions pages would be removed from the wikis, at a yet to-be-defined date.

Structured Discussions' deprecation

The Wikimedia Foundation working on changes to how IP editing is handled: IP Editing: Privacy Enhancement and Abuse Mitigation. Temporary accounts for unregistered editors will be a new type of user account. This requires changing how the features we use to contribute to the wikis' work.

This work concerns all features, and it raises some challenges. The case of Structured Discussions (also known as “SD” or “Flow”) is one of them. This extension is used at a few wikis, that are progressively contacted in November and December 2023. Flow is a complex piece of software that was never quite finished, fits poorly into the MediaWiki architecture, and creates a significant number of technical errors.

The usage of Structured Discussions is low. In August 2023, on average DiscussionTools is used about 18,780 times per day, while Structured Discussions is used about 250 times per day, mainly at French Wikipedia.

We considered several options to adapt Structured Discussions: a full adaptation; a partial adaptation where Temp accounts can respond but not create new conversations. All of them would take a lot of time and effort for a short-term benefit. Also, the Wikimedia Foundation's long-term plan is to remove Structured Discussions from the wikis, mainly due to the maintenance cost. As a consequence, we prefer to avoid adapting Structured Discussions to Temporary accounts.

We take the opportunity of the work around Temporary accounts to question the concerned communities regarding the future of Structured Discussions.

DiscussionTools is the replacement for Structured Discussions. They are the default discussion system at all wikis. They allow anyone to start, reply or subscribe to a conversation. They provide a visual experience on wikitext-based conversations, and they cover the vast majority of features Structured Discussions offer.

The goal with this conversation is to respond to community's questions regarding the archival of Structured Discussions.

The idea is to proceed in two stages:

  1. discussion pages using SD are archived as subpages. They are replaced by a classic discussion page. In this way, the most active pages will already be ready when we proceed to step 2.
  2. SD are removed from the wiki. Existing pages (including archived ones) will be converted to a format yet to be defined.

We encourage communities to start the first step.

Questions asked to the communities

Starting at the end of November 2023, communities where Structured Discussions are still in use are progressively informed of the upcoming deprecation. We ask them the following questions:

  1. Are the reasons given for archiving structured discussions clear?
  2. Are the two steps outlined above for archiving and uninstalling structured discussions clear?
  3. If so, what is a reasonable timeframe for archiving pages for deinstallation? At present, deinstallation is not planned on our side (even if the second quarter of 2024 is mentioned), as we are waiting for the end of these conversations, which take place on multiple wikis.
  4. In your opinion, what format should pages currently using SDs be converted to when we proceed with the deinstallation of structured discussions?

Communities discussions report

Structured Discussions and DiscussionTools Comparative review

Main characteristics

Status of each tool, and their integration to the wiki's key features.

LiquidThreads 構造化された議論 DiscussionTools Convenient Discussions
Type of tool MediaWiki extension Gadget/Userscript based on DiscussionTools
Release status Unmaintained Maintained (Wikimedia Foundation) Maintained (Volunteers)
Activation Pending removal[1] Wiki opt-in, user configurable User opt-in and configurable
Visual editing N 未完了 Yes 完了 Yes 完了 N 未完了
Backwards-compatibility with wikitext N 未完了 N 未完了 Yes 完了 Yes 完了
Templates support Yes 完了 Yes 完了 未完了 部分的に完了Tables, templates and parser tags aren't allowed in replies in visual mode Yes 完了
Full history integration with the rest of the wiki Yes 完了 N 未完了 Yes 完了 Yes 完了
Mobile web support N 未完了 Yes 完了 Yes 完了 N 未完了
Mobile app support N 未完了 N 未完了 Yes 完了 N 未完了
Permalink to a given comment Yes 完了 Yes 完了 未完了 部分的に完了if the comment is not moved elsewhere.[2]

進行中 進行中

Discussion features

Interaction with talk pages and other comments.

LiquidThreads 構造化された議論 DiscussionTools Convenient Discussions
Dedicated workflow for starting a new topic Yes 完了 Yes 完了 Yes 完了 Yes 完了
Topic and contents preload Yes 完了 Yes 完了 Yes 完了 Yes 完了
Indication of new comments when you read a topic N 未完了 N 未完了 Yes 完了
Indication of edited comments when you read a topic Yes 完了 Yes 完了 N 未完了 Yes 完了
Each topic is a different pages/each conversation has a permalink Yes 完了 Yes 完了 進行中 進行中[2] 進行中 進行中[2]
Move topics between pages Yes 完了 N 未完了planned but not implemented 未完了 部分的に完了via wikitext editing, breaks links.[2]

See discussions on moving with the DiscussionTools UI.

Yes 完了
Include discussions on another page and reply to them there N 未完了 N 未完了planned, including cross-wiki transclusion , but not implemented Yes 完了via transclusion
Editing comments Yes 完了 Yes 完了 未完了 部分的に完了via wikitext editing the whole page or section. See T242562 and T245225 for the editing of individual comments. Yes 完了
Thank a comment from within the talk page 未完了 部分的に完了via Page history Yes 完了 未完了 部分的に完了via Thanks in Page history.
進行中 進行中Work on supporting "Thanking" from the DiscussionTools UI is being tracked.
Yes 完了
Sort topics by recent comment Yes 完了 Yes 完了 N 未完了 N 未完了
Sort topics by start date Yes 完了 Yes 完了 N 未完了 N 未完了
Summarize a discussion at the top of it Yes 完了 Yes 完了 未完了 部分的に完了by editing opening comment.
Mark a message as read or unread Yes 完了 N 未完了 N 未完了 N 未完了
Show/hide (collapse) subthreads Yes 完了 N 未完了 N 未完了 Yes 完了

Notifications and interactivity


LiquidThreads 構造化された議論 DiscussionTools Convenient Discussions
Highlight a set of unread comments N 未完了 Yes 完了 Yes 完了only when subscribed to a topic and using links from notifications Yes 完了
Subscribe to be notified about new comments to a topic Yes 完了via Watchlist Yes 完了 – Echo 経由 Yes 完了via Echo or itself
Be notified when a new topic is started on a talk page
Auto-subscription to a topic you created Yes 完了default
Highlight a quoted comment N 未完了can link to comments but only as standalone pages Yes 完了 Yes 完了 Yes 完了
Notification of edited comments 未完了 部分的に完了only on your own comments Yes 完了 N 未完了 N 未完了


Maintenance and moderation

LiquidThreads 構造化された議論 DiscussionTools Convenient Discussions
Direct access to user talkpage, contribs and more 未完了 部分的に完了if linked in the signature Yes 完了 未完了 部分的に完了if linked in the signature
Hide (moderate) a comment 未完了 部分的に完了no undelete UI Yes 完了 未完了 部分的に完了{{$2|取り消し/差し戻し}}経由 Yes 完了
Hide or delete a topic Yes 完了 未完了 部分的に完了same as DiscussionTools
Archiving discussions 未完了 不要 未完了 不要 N 未完了see T337293
  • Requires 3rd party bots for automatic archival
  • Requires wikitext editing or 3rd party gadgets for manual archival
N 未完了Same as DiscussionTools, though moving topics can be used for manual archival.
Report an inappropriate comment N 未完了 N 未完了 進行中 進行中[3] N 未完了


Data on usage

In August 2023, on average:

  • DiscussionTools is used about 18,780 times per day.
  • Flow is used about 250 times per day, mainly at French Wikipedia.
  • LiquidThreads is used less than once per day.

Notes and references

  1. https://phabricator.wikimedia.org/T332022
  2. T339247Create entry points for the Incident Report dialog with DiscussionTools