On the plugin menu, add an activation reminder banner:

I don't think it's possible to run any code until the plugin is activated.

Add an installation tab on the landing page with post-installation steps:

What is the "landing page" mentioned here. Is it the plugin page?

@SBisson Yes, landing page here means the plugin page.

Hello @SBisson, not sure what's best way to update this task so first dropping a comment with all design details. I will update the task if all looks good.

UX details

• Present post-activation instruction once users activate the plugin.
• These instructions come only for once. If users leave the instructions page then they won't be able to see them again.

Steps to add instructions

• Add following heading first followed by an illustration.

Enhance your website with free knowledge straight from Wikipedia!

• Add following copy below the illustration

Wikipedia Preview lets you show a popup card with a short summary from Wikipedia when a reader clicks or hovers over a link.
Wikipedia Preview is easy to set up and use. Simply follow these steps:

• Add first bullet point followed by an illustration.

1. Highlight the text you want to link to a Wikipedia article.

• Add second bullet point followed by an illustration.

2. Select ‘Wikipedia Preview’ from the menu.

• Add third bullet point followed by an illustration.

3. You will see a list of suggested articles. Select the one you want to link to.

• Add fourth bullet point followed by an illustration.

4. Wikipedia Preview will automatically turn the link into a preview of the relevant Wikipedia article. You can easily edit or remove this.

Below mockup is just an example to show how all of this will look together.

Note: We are going to make some css related changes(adding border to images, adjusting their size, margins, padding, etc.) once instructions will be available in the code format.

@SGautam_WMF it looks good. Feel free to update the task description. Let's try to do a quick walk-through during the daily next week to make sure there is no open questions from the engineers before we make it ready for dev.

@SGautam_WMF could you share which plugin is showing a welcome page like this so I can check how they did it?

sure @SBisson , here are some of them.

• Jetpack
• Akismet spam protection
• Site kit by Google - This one doesn't show instructions right after activation but shows a pretty big banner on top which I found interesting so thought of sharing with you.

https://github.com/wikimedia/wikipediapreview-wordpress/pull/69

a) Classic Editor Copy: Add a Preview link to your site’s content (i.e. a word or a phrase you want to provide context for).

Is there a handler for Classic Editor in this task?

In T319542#8588564, @hueitan wrote:

a) Classic Editor Copy: Add a Preview link to your site’s content (i.e. a word or a phrase you want to provide context for).

Is there a handler for Classic Editor in this task?

We discussed not showing it for the classic editor but @SGautam_WMF can confirm.

@hueitan as Stephane mentioned, we are not showing these for classic editor.

The PR is merged

Bringing this back to dev to 1) fix the publish script and 2) see if we can make the intro page transient (as opposed to permanent in the settings menu).

To have the page be non-permanent in settings menu: https://github.com/wikimedia/wikipediapreview-wordpress/pull/74

in the end, please add the following note as well
Note: These instructions are specifically applicable to the Gutenberg editor.

@SGautam_WMF this is the only piece missing from this task. Let us know if this is still relevant since we are only showing the instruction page to the Gutenberg users.

In T319542#8623017, @SBisson wrote:

in the end, please add the following note as well
Note: These instructions are specifically applicable to the Gutenberg editor.

@SGautam_WMF this is the only piece missing from this task. Let us know if this is still relevant since we are only showing the instruction page to the Gutenberg users.

We can ignore this part. Updated the task as well.