[Cookbook] New cookbok: How to use the Cloud to send Emails

[bicpi]

Q	A
Doc fix?	no
New docs?	yes
Applies to	all
Fixed tickets	-

This is a new cookbook article as proposed in #3193, I hope you like it.

Please let me know if there's something I can improve, especially regarding my English ;-)

[xabbuh]

Maybe I'm wrong but shouldn't this be "How to Use the Cloud to Send E-Mails" according to our new guidelines?

[xabbuh]

At least I prefer E-Mail over Email

[bicpi]

I've used the Gmail cookbook as a base for this one.
So if we change it we may should change it in the whole docs, otherwise it would for example read like

• How to use Gmail to send Emails
• How to use the Cloud to Send E-Mails
  in the TOC.

Btw, I've found a lot of such words that are spelled differently across the docs; I'll create an issue listing them, we could vote for the correct one and then I'll update the docs.

[bicpi]

Thanks @xabbuh and @wouterj for your feedback, I've implemented the most of it, except "email" vs. "e-mail", see also #3237 - "email" seems to be used more in the docs and in general.

I've also applied the changes to the Gmail cookbook, where applicable:

• heading notation
• full XML configuration
• single/double quotes in PHP
• typo

[wouterj]

I prefer to put /> on a new line, on the same indent level as the open tag

[bicpi]

Any agreement on the email vs. e-mail topic?

Currently, e-mail is only used 5x throughout the docs - would be an easy fix.

[bicpi]

After some more research, the unhyphenated email form is more common, can we agree on this?

[weaverryan]

This is a really nice entry - I appreciate the detail about parameters.yml and the notes at the bottom. Really great job Philipp!

[bicpi]

@weaverryan Thank you ☺️

[xabbuh]

Is there a problem with the build process? The merge has been performed a few days ago but is still not reflected in the docs.

[bicpi]

Are the docs rebuilt every night or when does it happen actually?

[xabbuh]

According to the contributing docs it should be:

[...] it is updated each French night at 3AM when the server rebuilds the documentation [...]

[bicpi]

Oh, thanks, I remember reading that a long time ago!

[wouterj]

In that same article:

Please be patient. It can take from 15 minutes to several days for your changes to appear on the symfony.com website after the documentation team merges your pull request.

I suggest we wait for a couple more days, it's wuite random if you ask me

[weaverryan]

Yea, I would also have expected it to have been built by now too - iirc, it does a simple build every 15 minutes (not sure what it entails, but maybe only updated docs) and a full, fresh one nightly.

Let's wait a few days and then start bothering some people :) (I don't have access to this part either)

[wouterj]

yeah, with the cmf, new images are usually uploaded during the night and new text quite fast after merging. However, this is a bit random, as I always have the feeling that CMF is quicker updated as this doc and I added "to several days" after it took a full week before my PR was build online.

[xabbuh]

I feel like the build process currently doesn't work at all. The build errors page shows only outdated errors.

[wouterj]

ping @javiereguiluz (sorry for pinging you so often)

[javiereguiluz]

@wouterj looking into it! And don't worry for the pings, because you can (and should) ping me as many times as you need.

[javiereguiluz]

@xabbuh @wouterj the documentation build errors are updated again thanks to @fabpot

You can see them at http://symfony.com/doc/build_errors

[xabbuh]

@javiereguiluz Great! Thank you! Now, this new cookbook article is also available.

[xabbuh]

Fixed the build errors in #3650.