In this task, we write and translate the "quick start tips" content that goes inside the suggested edit screen for guidance: T244541: Newcomer tasks: suggested edit screen in guidance
The content is in this spreadsheet: https://docs.google.com/spreadsheets/d/1qrFFQ1TbNUwn_Efwj9TB4uurv_HyksHKnXn9gH3ppew/edit?ts=5e508718#gid=0
Here's how it works:
- For each of our five task types, the sheet lists each quick start tip in a separate row.
- Tip number: each task type has 6 tips, except "References", which has 7.
- Tip role: this column column is just for us to keep track of what the point of that tip is -- this is not for translating or showing to the user.
- Desktop text: this is the main text that should be shown in the tip.
- Mobile text (if different): in most cases, the mobile text can be the same as the desktop text, but this column contains a value if it should be different.
- Supplement: this is illustrative content that should be below the main text in the panel. This can take several forms:
- Text with formatting: in these cases, there is some translatable text, along with highlighting applied to part of the text, which serves to illustrate the kind of edit the tip is talking about.
- Caption: sometimes we want to include a small, italicized caption under the the supplement.
- Icon: this is when we want to just display a large version of some icon that we're asking the user to click on, like the "cite" icon.
- Link: this is when we want some part of the main text to be a hyperlink. For the links that are on the final quick tip for each task type (about "learning more"), we should follow the same logic and links as we did with the task explanation widget from T235046: Newcomer tasks: task explanation widget. If a wiki has a link available for a given task type, then the line with the link in it should show up in the quick tip. If it does not have a link, it should not even have the line. For cells in the spreadsheet like F25 and F31, the link in the text should likewise only be made if the wiki has a link for that type of task. And although T235046 only shows our four target wikis, this would naturally apply to the other wikis that have newcomer tasks, and whichever links they have along with their task explanation widgets.
- Graphic: this is when we just display a pre-existing graphic that our designer can supply.
- Desktop QQQ: explanation of desktop text for translators, including link to desktop prototype.
- Mobile QQQ: explanation of mobile text for translators, including link to mobile prototype.
- Supplement QQQ: explanation of supplement text for translators.
Note that this content is all geared toward Visual Editor on both desktop and mobile. This is because we think that newcomers will have a better experience in Visual Editor, and it is easier to describe to them how to succeed on their first edits in that interface. That said, we should set up this feature so that it is possible to also set up guidance content for wikitext editors in the future, if we work with communities that would prefer to nudge newcomers to that editor instead. Perhaps this simply means being mindful of what we name these messages.