The discussion revolves around sending a tailored welcome PM to new moderators and admins, linking them to a moderator guide. codinghorror suggests deferring to a guide, and jomaxro agrees that a link to the moderator guide is a good first step. Chaboi_3000 proposes using an animated GIF to demonstrate functionality, but codinghorror notes that static images become outdated quickly, making a wiki link more sustainable. sam confirms the need for a single, customizable guide topic and suggests starting with a simple link. jomaxro clarifies that linking to the existing guide at https://meta.discourse.org/t/discourse-moderation-guide/63116 is preferable to a community-specific seeded topic to avoid outdated content. sam supports this as a first step, noting that communities can customize the link via admin/customize/site_texts. Chaboi_3000 agrees, showing a sample PM from their forum. vinothkannans confirms the feature is partially implemented, with a PR adding welcome PMs for admins.
I agree a good first step would be to send a link to the moderator guide. It would certainly be interesting to create a discobot tutorial for staff, but that will be very involved, as it would need to take staff out of the PM, unlike the user tutorial.
My idea is that we just show an animated GIF of how it works, instead of actually making the staff member do it. Otherwise, we need someone to suspend/silence/impersonate, etc. I think it’s better of showing how it works, instead of making them do it.
The problem is these pictures and gifs get out of date. So it is better to link to a wiki topic which can more easily be kept up to date in a single place.
@vinothkannans can you add this to your list, work with @codinghorror and @jomaxro on figuring out mechanics, location of this wiki content and so on.
I assume we are talking about seeding 1 more topic here as “moderator guide” that a community can own and customise to fit their existing rules and conventions.
Also clarifying here, I assume we want this magic PM to be sent once (and only once) to every moderator on the site? The trigger then would be either inviting a new moderator, or upgrading an existing account to moderator.
Understood, but we got to start with baby steps here and @gerhard is in the midst of re-doing how we seed some of this content in light of localisation.
So simply emailing a link is a good first step and if you want it to link to your custom guide it is a simple change in admin/customize/site_texts.