Documentation location/URL

https://new.drupal.org/docs/drupal-cms/configuration/set-up-email-sending

Problem/Motivation

In "Step #1: Gather your SMTP connection information," the first sentence is "Google requires that you create an App Password in your Google account:"

Some people may have multiple email addresses for the same site or domain name, such as admin@example.com, mail@example.com, or janedoe@example.com.

Proposed resolution

It would be helpful to specify which account should be used for creating the App Password.

For example, that sentence might be revised to say "Google requires that you create an App Password in your Google account. Use the Google account that matches the email address on the Configuration > System > Basic site settings page."

(The bold indicates the suggested addition; it does not need to be bold if added to the documentation.)

If this is not correct and it doesn't matter which email address is used, it would be helpful to state that, too.

Comments

camhoward created an issue. See original summary.

avpaderno’s picture

avpaderno
he/him
Primary language Italian
Location Brescia, 🇮🇹 🇪🇺
commented
Title: Suggestion for: Set up email sending » Make clear which account should be used for creating the App Password in "Set up email sending"
Issue summary: View changes
avpaderno’s picture

avpaderno
he/him
Primary language Italian
Location Brescia, 🇮🇹 🇪🇺
commented

At the moment, the documentation on new.drupal.org can be edited by a more restricted group of people, compared to the documentation on drupal.org. I am not sure this will eventually change, but at the moment only two people edited that page.

camhoward’s picture

camhoward
Location New Hampshire, USA
commented

Thanks for the update, @avpaderno. And thanks for changing the issue title to something more descriptive than the default title the form provided and I left in place when I submitted the issue.

I hope the suggestion to clarify this is helpful. I understand that the two people editing the documentation on new.drupal.org may or may not make any changes.

eojthebrave’s picture

eojthebrave
he/him
Primary language English
Location Minneapolis, MN
commented
Status: Active » Fixed

Thanks for the suggestion. I've updated the page. And yeah as far as I understand it new.drupal.org is still a work-in-progress and the permissions to allow the broader community to edit docs pages are still being sorted out.

Now that this issue is closed, please review the contribution record.

As a contributor, attribute any organization helped you, or if you volunteered your own time.

Maintainers, please credit people who helped resolve this issue.

camhoward’s picture

camhoward
Location New Hampshire, USA
commented

@eojthebrave -- Thanks! Your revision looks good and will be very helpful. Thanks for the contribution credit, too!

No worries about the current editing process for new.drupal.org. I appreciate you making the change. Thanks!

Status: Fixed » Closed (fixed)

Automatically closed - issue fixed for 2 weeks with no activity.