@gonyeahialam we are wondering where this empty state image is.

Preliminary feedback from the Usability test for the Invitation lists MVP
(Urgent feedback that needs to be worked on for people to be able to use the tool.)

• Most participants didn't read the information on this page.

@gonyeahialam: Thank you for this feedback! Do you have a recommendation that may help encourage more people to read the page?

Change #1047994 had a related patch set uploaded (by Mhorsey; author: Mhorsey):

[mediawiki/extensions/CampaignEvents@master] Add new special page for MyInvitationLists

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

A few questions/thoughts:

• The AC say that the title of the page would be "Invitation lists", but the prototype has "My invitation lists". Which one is correct?
• T365068 has been closed as duplicate. Should we just copy the relevant parts from the AC of T356679, for what concerns feature enabled vs disabled and logged out vs not authorized vs authorized?
• The explanatory text and button label are also different, so I'd like to confirm whether we should go with what's in the AC:

AC:    Discover new participants for your events. Provide an article list and get a list of editors likely to be interested in your event.
Specs: Discover new participants for your event. Provide a list of articles that cover the topics of your event and get an invitation list of editors likely to participate in your event.

Thanks for pointing this out, @Daimona!

In T364791#9912005, @Daimona wrote:

A few questions/thoughts:

• The AC say that the title of the page would be "Invitation lists", but the prototype has "My invitation lists". Which one is correct?

Neither! Thanks for catching this. I think we should follow the format of MyEvents, which has "Your events" as its page title, so I have updated the AC to be "Your invitation lists"

• T365068 has been closed as duplicate. Should we just copy the relevant parts from the AC of T356679, for what concerns feature enabled vs disabled and logged out vs not authorized vs authorized?

Done! Let me know if it looks good/there are any concerns.

• The explanatory text and button label are also different, so I'd like to confirm whether we should go with what's in the AC:

Explanatory text

AC:    Discover new participants for your events. Provide an article list and get a list of editors likely to be interested in your event.
Specs: Discover new participants for your event. Provide a list of articles that cover the topics of your event and get an invitation list of editors likely to participate in your event.

So, I think there are good bits of both to keep, but I also think some changes should be made since our thinking around the use of this feature has evolved recently. Some of my thoughts/opinions include:

• We should say it is for projects and events (rather than just events). This is because the feature could be useful for WikiProjects, affiliates, and other initiatives.
• We may want to more clearly define what is an "invitation list," since the concept may not be understood by everyone immediately.
• What should be changed about the spec example: We shouldn't say "likely to participate" because I think that is over-promising and not accurate. It is more accurate to say that they are likely to be interested or something along those lines.
• What should be changed about the original AC example: It doesn't say what the article list is about or should include, so I like that the spec example provides more details.

This has led me to come up with this text: "Discover new participants for your project or event. Provide a list of articles that cover your topical focus areas. Then, you will receive an invitation list, which is a list of editors who may be interested in joining your project or event."

@gonyeahialam, @EUwandu-WMF, and @Udehb-WMF, curious if you have any suggestions on how to improve the explanatory text/language for the feature for first time users.

If there are no major objections or suggested improvements, we can go with this text for the MVP.

@gonyeahialam Two questions about the image:

• Is there a repository for these where we can copy the SVG from? Copying directly from Figma gives a hefty 4MB SVG, but I assume there's an optimized version somewhere.
• Since the image represents a written document, we need a flipped version of it for RTL languages. I would assume that the flipped version can be found where this image lives.

UPDATE: We discussed the image in the team meeting today with @gonyeahialam, who shared that some people found the image confusing in usability tests. I agree, since the image is for an article, whereas this tool is for generating an invitation list. Meanwhile, some technical questions/complexities have come up around the image (see above comment). For this reason, we have decided to remove the image from the MVP, so the empty state will only display text and the 'Create' button. cc @MHorsey-WMF @cmelo @Daimona @vaughnwalters

@ifried can we confirm the text changes above.

@MHorsey-WMF: Thanks for checking in on this. I did another read through of the text and made some final tweaks. It is now ready for implementation.

Change #1047994 merged by jenkins-bot:

[mediawiki/extensions/CampaignEvents@master] Add new special page for MyInvitationLists

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

@ifried I suggest changing the name of this page from MyInvitationLists to YourInvitationLists to be inline with the Voice and Tone guidelines and consistent with the YourEvents page naming.

In our team meeting, we have discussed that we keep AC since it conforms to current standards that we have in Event Registration, so we will keep Special:MyInvitationLists but the title in the interface is 'Your invitation Lists.'

In T364791#9912139, @ifried wrote:

Thanks for pointing this out, @Daimona!

In T364791#9912005, @Daimona wrote:

A few questions/thoughts:

• The AC say that the title of the page would be "Invitation lists", but the prototype has "My invitation lists". Which one is correct?

Neither! Thanks for catching this. I think we should follow the format of MyEvents, which has "Your events" as its page title, so I have updated the AC to be "Your invitation lists"

• T365068 has been closed as duplicate. Should we just copy the relevant parts from the AC of T356679, for what concerns feature enabled vs disabled and logged out vs not authorized vs authorized?

Done! Let me know if it looks good/there are any concerns.

• The explanatory text and button label are also different, so I'd like to confirm whether we should go with what's in the AC:

Explanatory text

AC:    Discover new participants for your events. Provide an article list and get a list of editors likely to be interested in your event.
Specs: Discover new participants for your event. Provide a list of articles that cover the topics of your event and get an invitation list of editors likely to participate in your event.

So, I think there are good bits of both to keep, but I also think some changes should be made since our thinking around the use of this feature has evolved recently. Some of my thoughts/opinions include:

• We should say it is for projects and events (rather than just events). This is because the feature could be useful for WikiProjects, affiliates, and other initiatives.
• We may want to more clearly define what is an "invitation list," since the concept may not be understood by everyone immediately.
• What should be changed about the spec example: We shouldn't say "likely to participate" because I think that is over-promising and not accurate. It is more accurate to say that they are likely to be interested or something along those lines.
• What should be changed about the original AC example: It doesn't say what the article list is about or should include, so I like that the spec example provides more details.

This has led me to come up with this text: "Discover new participants for your project or event. Provide a list of articles that cover your topical focus areas. Then, you will receive an invitation list, which is a list of editors who may be interested in joining your project or event."

@gonyeahialam, @EUwandu-WMF, and @Udehb-WMF, curious if you have any suggestions on how to improve the explanatory text/language for the feature for first time users.

If there are no major objections or suggested improvements, we can go with this text for the MVP.

@ifried The suggested copy is good, my only concern is that 'topical focus areas' seems like a complex phrase, is it something organizers will easily understand

Thanks for pointing this out! Do you have a suggestion for something that you think may be more clear, @gonyeahialam? "Topical focus areas" was the best that I could come up with, but maybe you can think of something better! :)

Perhaps @Sadads also has a suggestion on if/how the text can be improved (specifically, if "topical focus areas" can be improved). Here is the text that we use the explain the Invitation Lists feature to new users of the tool: "Discover new participants for your project or event. Provide a list of articles that cover your topical focus areas. Then, you will receive an invitation list of editors who may be interested in joining your project or event."

Suggested wording: "Discover potential participants for your project or event. Provide a list of articles that cover your activity's topical focus areas. Then, you will receive an invitation list of editors who may be interested in joining your project or event."

I don't think there are many other better ways to improve it though.

@ifried 'list of articles that cover the topics of your activity' or 'list of articles that cover the topics of your project or event' seem simpler.

Thank you, @Sadads & @gonyeahialam! I have updated the copy, cc @MHorsey-WMF.

Acceptance Criteria:

• Given that a user is on a Wikipedia wiki that has the CampaignEvents extension enabled,
  • And if the user has the Event Organizer right on that wiki,
    • ✅ They can access a new page called Special:MyInvitationLists
• Given that a user is on Special:MyInvitationLists, they should see:
  • ✅ The page title "Your invitation lists"
  • ❌ Explanatory text: "Discover new participants for your project or event. Provide a list of articles that cover the topics of your activity. Then, you will receive an invitation list of editors who may be interested in joining your project or event."
    • The text in the AC is different than is in the build:
      • AC: articles that cover the topics of your activity.
      • Build: articles that cover your topical focus areas.
  • ✅ Button "Create new invitation list"
• Given that the user clicks on "Create new invitation list",
  • ✅ They should be brought to Special:GenerateInvitationList
  • 
• Given that a user accesses Special:MyInvitationLists,
  • And the wiki does not have Invitation Lists enabled,
    • And the user is either logged in or logged out,
      • ✅ They should see the following message: This wiki does not have invitation lists enabled.
      • 
• Given that a user accesses Special:MyInvitationLists,
  • And the wiki has Invitation Lists enabled,
    • And the user does not have the Event organizer right,
      • ✅ They should see the following message: You are not allowed to use invitation lists.
      • 
• Given that a user accesses Special:MyInvitationLists,
  • And the wiki has Invitation Lists enabled,
    • And the user is logged out,
      • ✅ They should be redirected to login

@MHorsey-WMF All AC is met except for one line of copy in the Explanatory text above.

Change #1054320 had a related patch set uploaded (by Mhorsey; author: Mhorsey):

[mediawiki/extensions/CampaignEvents@master] Updated text for empty state on Special:MyInvitations

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

Updated the text in a new patch.

Change #1054320 merged by jenkins-bot:

[mediawiki/extensions/CampaignEvents@master] Updated text for empty state on Special:MyInvitations

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

In T364791#9981016, @MHorsey-WMF wrote:

Updated the text in a new patch.

• Given that a user is on Special:MyInvitationLists, they should see:
  • ✅ Explanatory text: "Discover new participants for your project or event. Provide a list of articles that cover the topics of your activity. Then, you will receive an invitation list of editors who may be interested in joining your project or event."

The copy has been updated to meet the AC, and now all AC is met. Sending to design sign off