This task involves the work with defining what people will experience when the software cannot be certain where the comment people are looking for is located. //See the `===Cases` below for the list of scenarios in which people might encounter this scenario.//
NOTE: you can try the WIP user experience using this patch demo: https://patchdemo.wmflabs.org/wikis/72d6e719c1/wiki/Test_cases
=== Stories
- **As someone** who is trying to view a comment that the software cannot confidently locate and take me to, **I want to** know that the software cannot locate the comment I am seeking, why it cannot locate said comment, and where I might look to find said comment, **so that** I can: **A)** increase the chances that I can find the comment I'm seeking myself and **B)** form more accurate expectations for what the comment linking feature is and is not capable of.
=== Requirements
NOTE: @ppelberg needs to update requirements to reflect outcomes of 27 Sep 2023 team meeting.
**I. The moment people land on the [Special:FindComment](https://patchdemo.wmflabs.org/wikis/72d6e719c1/wiki/Special:FindComment) page**
**II. The [Special:FindComment](https://patchdemo.wmflabs.org/wikis/72d6e719c1/wiki/Special:FindComment) page itself **
//As the UX is currently implemented, this is the page people will arrive on in all of the `===Cases` listed below.//
**III. The moment after people tap/click a link that is shown to them on the [Special:FindComment](https://patchdemo.wmflabs.org/wikis/72d6e719c1/wiki/Special:FindComment) page**
=== Mockups
=== Open Questions
- [x] 1. What are all of the cases we need to consider as part of this task?
-- //See T304579#8097154.//
- [x] 2. How might someone generate a link to a comment before the permanent links feature gets deployed?
-- This was made possible by way of https://meta.wikimedia.org/w/index.php?title=User:ESanders_(WMF)/commentlinks.js
- [x] 3. What would be involved with back-filling the data for older comments?
-- See: T315510
=== Done
- [ ] Answers to all `Open questions` are documented
- [ ] `Requirements` are documented
- [ ] `Mockups` are added and implemented
---
=== Cases
//This section contains the list of cases we will need to design the user experience for; it is borrowed from what @matmarex has documented on mediawiki.org: [Extension:DiscussionTools/How_it_works#Permanent_links](https://www.mediawiki.org/wiki/Extension:DiscussionTools/How_it_works#Permanent_links).//
**Case #1: the comment //might// not visible anywhere**
- //Potential reasons://
-- The comment being linked to never existed in the first place, and the link is wrong
-- The comment being linked to has been removed from the page (removing comments outright is rare, but occasionally done for off-topic, redundant or offensive comments)
-- The comment being linked to has been edited in a way that breaks our identification (e.g. deleting and re-adding a signature)
-- The comment being linked to was supposed to be archived/moved by cut-and-paste, but something went wrong with the second half of the operation and it was just deleted
-- The [discussion item database](https://www.mediawiki.org/wiki/Extension:DiscussionTools/How_it_works#Discussion_item_database) hasn't been populated for that page.
**Case #2: the comment //might// be visible in more than one place**
- //Potential reasons://
-- The comment being linked to is actually two indistinguishable comments on different pages (read: two comments with the same author, date and time)
-- The comment being linked to was supposed to be archived/moved by cut-and-paste, but something went wrong with the first half of the operation and it was just copied
-- The comment being linked to might be transcluded on multiple pages (we ignore transclusions when looking for the redirect target, so this doesn't lead to the scenario below)
**Case #3: the comment //might// be older than the permalinks feature**
//The feature only has data about comments added after it has been deployed.//