1397786 - Update branding and discussion link in welcome email

Status: RESOLVED FIXED

(developer.mozilla.org Graveyard :: Setup / Install, enhancement)

Description

[Janet Swisher]

What feature should be changed? Please provide the URL of the feature if possible.
==================================================================================
In the email that is sent when a profile is created, change the name of the site to "MDN web docs" rather than "Mozilla Developer Network (MDN)", and change the link to the mailing list to point to Discourse instead.

What problems would this solve?
===============================
Users seeing incorrect branding and trying to subscribe to the mailing list. 

Who would use this?
===================
New profile owners. 

What would users see?
=====================
Corrected text 

What would users do? What would happen as a result?
===================================================
Users would be more likely to come to the Discourse forum.

Is there anything else we should know?
======================================

Comment 1

[Janet Swisher]

list_link should be https://discourse.mozilla.org/c/mdn

-Mailing list: <a href="{{ list_link }}">subscribe</a> to tell us about what you're interested in on MDN and ask questions about the site.
+Discussion forum: <a href="{{ list_link }}">join</a> to tell us about what you're interested in on MDN and ask questions about the site.

Comment 2

[John Whitlock [:jwhitlock]]

There are other places in the kuma code that refer to dev-mdc and dev-mdn mailing lists, that should also be dealt with.

Comment 3

[John Whitlock [:jwhitlock]]

Here's the specific areas to update, and the suggested actions:

dev-mdn - https://github.com/mozilla/kuma/search?utf8=✓&q=dev-mdn&type=

* README.rst [1] - Update to Discourse
* CONTRIBUTING.md [2] - Update to Discourse
* contribute.json [3] - Update to Discourse
* kuma/settings/common.py [4] - MSGID_BUGS_ADDRESS update to [e-mail]
* docker/images/mysql/Dockerfile [5] - Remove MAINTAINER line
* docs/troubleshooting.rst [6] - Update to Discourse

dev-mdc - https://github.com/mozilla/kuma/search?utf8=✓&q=dev-mdc&type=

* kuma/users/jinja2/users/email/welcome/html.ltxt [7] - Update as suggested in #c1
* kuma/users/jinja2/users/email/welcome/plain.ltxt [8] - Update as suggested in #c1

[1] https://github.com/mozilla/kuma/blob/0dea0c13244d38d2deb3bc95916c13d05622c710/README.rst
[2] https://github.com/mozilla/kuma/blob/1c1642d4c351529a4786288c1cf98ab4d4020b0f/CONTRIBUTING.md
[3] https://github.com/mozilla/kuma/blob/f19cc73ec317756e85b2db0847ad4aabea7a438c/contribute.json
[4] https://github.com/mozilla/kuma/blob/068486f7522f818f963d772e23293f0542163cc9/kuma/settings/common.py#L627
[5] https://github.com/mozilla/kuma/blob/695a93b2f84905c93a047bc72b777245d1a3b3eb/docker/images/mysql/Dockerfile#L3
[6] https://github.com/mozilla/kuma/blob/da20df580e3c7b22e27ac57c53eef2d50e8cf4ff/docs/troubleshooting.rst
[7] https://github.com/mozilla/kuma/blob/00fc05b101658f863f58d7fc2b1aefecbcf71cf8/kuma/users/jinja2/users/email/welcome/html.ltxt#L38-L40
[8] https://github.com/mozilla/kuma/blob/00fc05b101658f863f58d7fc2b1aefecbcf71cf8/kuma/users/jinja2/users/email/welcome/plain.ltxt#L33

Comment 4

[gagyibenedek]

I'm interested in this! Especially since it's mentored, and I'm pretty lost right now :)
What are the next steps?

Comment 5

[John Whitlock [:jwhitlock]]

gagyibenedek,

You'll want to start with installing a local Kuma development environment:

https://kuma.readthedocs.io/en/latest/installation.html

I suggest changing the two mail files, kuma/users/jinja2/users/email/welcome/html.ltxt and kuma/users/jinja2/users/email/welcome/plain.ltxt, first. You'll then need to open a pull request so we can review your changes. Keeping the first PR small will make it faster to review and merge.

Comment 6

[John Whitlock [:jwhitlock]]

gagyibenedek, I'm sorry, I'm updating some other documentation, and I'm going to take care of this one today. Removing the mentoring info.

Comment 7

[[github robot]]

Commits pushed to master at https://github.com/mozilla/kuma

https://github.com/mozilla/kuma/commit/e6561cc971114db3cc9302ca3e49e9b98ccb1ae0
bug 1397786: Replace mailing list with Discourse

* Change dev-mdc and dev-mdn links to Discourse
* Change dev-mdn email gateway to admin email

https://github.com/mozilla/kuma/commit/d55ae0152b2b47455593c0d3bc60dd5eab212560
Merge pull request #4460 from jwhitlock/discourse-1397786

bug 1397786: Update mailing list links to Discourse

Comment 8

[John Whitlock [:jwhitlock]]

The changes have been in production for about a month, and the translations are shipped for our most active l10n communities.  Here's the new email (the real-time chat bullet feels out of date...):

Hi <username>!

Thanks for creating a profile on Mozilla Developer Network (MDN) - a community making great resources for developers like you.

You've completed the first step of Getting Started on MDN by creating a profile.

Now, keep going by picking a task on MDN, and doing it! We have a bunch of intro tasks you can choose from, whether you like words, like code, like both words and code, or you want to translate MDN to your language.

Talk to us!
Want to talk to someone about MDN? There are a few ways you can do that:

* Discussion forum: join to tell us about what you're interested in on MDN and ask questions about the site.
* Real-time chat: #mdn channel on irc.mozilla.org. (Get more info about IRC.) You can find the MDN writing staff admins there: Eric Shepherd (sheppy), Jean-Yves Perrier (teoli), Will Bamberg (wbamberg), Florian Scholz (fscholz), Chris Mills (chrismills), and me (jms), MDN's community manager.
* Blog: On the about:community blog, look for the posts tagged with Developer Engagement.

Don't be shy, if you have any doubt, problems, questions: contact us! We are here to help.

Comment 9

[Janet Swisher]

Thanks for taking care of this, John!

A few updates:

* "Mozilla Developer Network (MDN)" should be "MDN Web Docs"
* Delete the blog bullet; we aren't actively using it. 
* In the real-time chat bullet, delete Jean-Yves (no longer writing staff), and change my nickname to jswisher.

Comment 10

[[github robot]]

Commits pushed to master at https://github.com/mozilla/kuma

https://github.com/mozilla/kuma/commit/235a3be2bba09d2ad6feb664a21439721754a36c
bug 1397786: Update welcome email

- Mozilla Developer Network -> MDN Web Docs
- Drop link to unused blog
- Remove Jean-Yves
- Update Janet's IRC handle

https://github.com/mozilla/kuma/commit/1ba75bddd773790ad16e4a956b601e3295cb0a6a
Merge pull request #4555 from jwhitlock/welcome-email-1397786

bug 1397786: Update welcome email

Comment 11

[John Whitlock [:jwhitlock]]

I've updated the welcome email and pushed the new strings to Pontoon. It appears the older translations will be used until the localizers can update them, which looks like it will be very fast for our main languages.