===Why are we doing this?
The intention is to make talk pages less overwhelming, informative, and more timely (help contributors identify recent discussions). Each topic is broken down into a cell that shows information like the title, an overview of the first comment, the timestamp, and how many people are participating in the discussion. This type of summary page for talk pages can be reutilized for user talk pages.
===Audience story
As a contributor/reader, I want to be sure what kind of talk page I land on.
===Relevant information
**Topics page**
([[ https://www.figma.com/file/E7YX2N8tQ94gyAeGcyqy8C/iOS-Talk-Pages?node-id=1370%3A29903 | Figma slide 4 ]] )
* Each topic is shown as a separate cell that will always have the same height, and it includes:
* Subscribe icon and button (only visible to those who are logged in)
* 2 line-height title, after that it truncates
* Timestamp
* 3 line-height preview of the first comment, after that it truncates
* Avatar icon & the number of contributors; speech bubble icon & the number of comments
* Tapping anywhere on the cell triggers the cell to open and reveal the whole thread.
| Logged out | Logged in |
| {F35221975} | {F35221977} |
**Notices & alerts (coffee roll) on top of the talk pages**
* Sometimes article talk pages have extra information about the content located above the topics called the coffee roll. This coffee roll often includes notices, alerts, and instructions.
* The information will be displayed right under the header.
* The coffee roll content will be displayed in a yellow card.
* The text will be truncated after 2 lines.
* There will be a ‘Read more’ button for people to see all of the coffee roll content.
* Once they tap on 'Read more' all of the content will be displayed in a separate page.
| Coffee roll on web article talk | On iOS topics page | Tapping 'Read more' takes you to the full content page |
| {F35317952} | {F35317942} | {F35317944} |
**Empty state**
([[ https://www.figma.com/file/E7YX2N8tQ94gyAeGcyqy8C/iOS-Talk-Pages?node-id=1370%3A29903 | Figma slide 3 ]] )
If the article talk page is empty, show the empty state underneath the article talk page header.
* Copy: Title: ‘The conversation starts here‘
* Next: ‘Talk pages are where people discuss how to make content on Wikipedia the best that it can be. Start by adding a new discussion topic to connect and collaborate with a community of Wikipedians.’
* Next: Button ‘Add a new topic’
| Empty state |
| {F35221973} |
**Entry points **
([[ https://www.figma.com/file/E7YX2N8tQ94gyAeGcyqy8C/iOS-Talk-Pages?node-id=1370%3A29903 | Figma slide 2 ]] )
Article talk pages can be accessed through:
* Notification center
* The contributor will tap on a new talk page message, and then tap on ‘View comment’ from the detail page view.
* Once ‘View comment’ is tapped, the topic inside of which the new comment is located will uncollapse. The contributor will be taken to the correct part of the thread where the comment is located to prevent them from scrolling to find the comment.
* Article page
* Accessed by tapping on the ‘View talk page’ at the bottom of any article.
**Relevant tickets**
- Add a new comment & text styles/formatting: T310291
- Threading: T310279
- Add a new topic: T310285
===Subscribe/unsubscribe to topic
[[ https://www.figma.com/file/E7YX2N8tQ94gyAeGcyqy8C/iOS-Talk-Pages?node-id=1370%3A29903 | Figma file Slide 8 ]]
**Audience story**
As someone who is interested in a specific topic on a talk page, I want to be able to get notifications when other people comment on it.
**Relevant information**
* Subscription is only available to logged-in contributors. So subscribe icon and button are revealed for logged-in contributors next to the down/up arrow.
* The feature ‘enables you to elect to receive a notification via Echo when someone posts a new comment in any conversation you have decided to "subscribe" to’.
* This feature is borrowed from the editing team's work.
* Phab ticket about manual topic subscription T263820
* In the future they hope for automatic subscription to be possible for the topics one has commented on. Found under T263819
**Activation**
* Tapping on the icon & button subscribes the contributor to the topic
**Toasts**
* A toast appears at the bottom of the page after **subscribing**
* Copy: Filled bell icon
* Next: ‘You have subscribed! You will receive notifications about new comments in this topic.’
* A toast appears at the bottom of the page after **unsubscribing**
* Copy: Filled bell slash icon
* Next: ‘You have unsubscribed. You will no longer receive notifications about new comments in this topic.’
| Subscribed | Unsubscribed | Logged out - topic page | Logged out - thread |
| {F35222353} | {F35222359} | {F35222357} | {F35222361} |
See more information about the UI in the - [[ https://www.figma.com/file/E7YX2N8tQ94gyAeGcyqy8C/iOS-Talk-Pages?node-id=1370%3A29903 | Figma file ‘Talk pages screens & specs' ]]
===Additional research and resources
- [[ https://docs.google.com/presentation/d/1wifraOKuy0-p0JPCEHtdfEFQ01u5BYVB22SQiGWnY5M/edit#slide=id.g100edd01f5e_0_0 | Communication on iOS: Talk pages]]
- [[ https://docs.google.com/presentation/d/1E5xrCbX5eTfXY2K0i_uHU5cS8s42aci15sGkEok_wMA/edit#slide=id.g520bc2121f_0_0 |Talk pages audit - iOS ]]
- [[ https://www.figma.com/file/CKyugF8bKsPF4lRAoPt2j0/User-map--journey-iOS?node-id=51%3A1183 | Talk Pages Journey Maps (Figma link) ]]
- [[ https://docs.google.com/presentation/d/15ZkkDzP_wK81qoNqbpQ0bD8fYIjlP0X3pNmXFp8s2Uc/edit#slide=id.p | Research on Talk Pages iOS Nov 2021 ]]
- [[ https://www.mediawiki.org/wiki/Talk_pages_project?tableofcontents=1
| Editing Team’s talk page project ]]