Skip to content

Commit 4a43200

Browse files
Merge pull request sendgrid#3823 from sendgrid/yoda
Copy editing and title changes
2 parents 05da9cd + 503b692 commit 4a43200

File tree

7 files changed

+43
-50
lines changed

7 files changed

+43
-50
lines changed

content/docs/for-developers/sending-email/curl-examples.md

Lines changed: 0 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -33,16 +33,6 @@ curl --request POST \
3333
--data '{"personalizations": [{"to": [{"email": "recipient@example.com"}],"cc": [{"email":"recipient2@example.com"}, {"email": "recipient3@example.com"}, {"email":"recipient4@example.com"}]}], "from": {"email": "sendeexampexample@example.com"},"subject":"Hello, World!", "content": [{"type": "text/plain", "value": "Heya!"}]}'
3434
```
3535

36-
## Sending a Basic Email to Multiple Recipients
37-
38-
```bash
39-
curl --request POST \
40-
--url https://api.sendgrid.com/v3/mail/send \
41-
--header 'authorization: Bearer YOUR_API_KEY' \
42-
--header 'Content-Type: application/json' \
43-
--data '{"personalizations": [{"to": [{"email": "recipient@example.com"}],"cc": [{"email":"recipient2@example.com"}, {"email": "recipient3@example.com"}, {"email":"recipient4@example.com"}]}], "from": {"email": "sendeexampexample@example.com"},"subject":"Hello, World!", "content": [{"type": "text/plain", "value": "Heya!"}]}'
44-
```
45-
4636
## Sending a Basic Email Using a Template
4737

4838
```bash

content/docs/for-developers/tracking-events/getting-started-event-webhook.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
22
seo:
3-
title: Getting Started
3+
title: Getting started with the Event Webhook
44
description: Use RequestBin to get started or to troubleshoot your Event Webhook.
55
keywords: webhook, RequestBin, troubleshoot, event webhook
6-
title: Getting Started
6+
title: Getting started with the Event Webhook
77
group: getting-started
88
weight: 100
99
layout: page

content/docs/for-developers/tracking-events/troubleshooting.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
22
seo:
3-
title: Troubleshooting
3+
title: Troubleshooting the Event Webhook
44
description: Tips and tricks to troubleshoot your SendGrid Event Webhook, including common issues.
55
keywords: event webhook, troubleshooting, events, duplication, load handling, duplicate events
6-
title: Troubleshooting
6+
title: Troubleshooting the Event Webhook
77
group: reference-troubleshooting
88
weight: 80
99
layout: page

content/docs/release-notes/2018-08-08.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,4 +7,4 @@ releaseType:
77

88
### Unsubscribe Group Workflow
99

10-
We’ve made managing your Unsubscribe Groups more intuitive and beautiful than ever. Create and edit Unsubscribe Groups with confidence, knowing exactly what your recipients will see, thanks to a side-by-side preview of both your Unsubscribe Preferences and confirmation pages. To learn more, take a look at our [documentation]({{root_url}}/User_Guide/Marketing_Campaigns/create-and-manage-unsubscribe-groups.html).
10+
We’ve made managing your Unsubscribe Groups more intuitive and beautiful than ever. Create and edit Unsubscribe Groups with confidence, knowing exactly what your recipients will see, thanks to a side-by-side preview of both your Unsubscribe Preferences and confirmation pages. To learn more, take a look at our [documentation]({{root_url}}/help-support/sending-email/create-and-manage-unsubscribe-groups/).

content/docs/ui/account-and-settings/dedicated-ip-addresses.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,8 +37,13 @@ Please see our document on [suggested IP allocation based on volume](https://sen
3737

3838

3939
## Adding an additional dedicated IP address
40+
<<<<<<< HEAD:content/docs/help-support/account-and-settings/dedicated-ip-addresses.md
41+
42+
You can purchase an additional dedicated IP Address from the IP Addresses Settings page or from your [Plan & Billing Details](https://app.sendgrid.com/settings/billing) page.
43+
=======
4044

4145
You can purchase an additional d IP Address from the IP Addresses Settings page or from your [Plan & Billing Details](https://app.sendgrid.com/settings/billing) page.
46+
>>>>>>> upstream/a-new-hope-episode-iv:content/docs/ui/account-and-settings/dedicated-ip-addresses.md
4247
4348
*To add an additional dedicated IP Address:*
4449

content/docs/ui/sending-email/cross-platform-html-design.md

Lines changed: 32 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -17,83 +17,81 @@ All Mail clients render HTML/CSS differently, in their own ways and for their ow
1717
## Layout
1818

1919
- **Avoid Using padding or margins**
20+
- Certain email clients don't support these formatting settings. For example, Outlook cannot support padding, and Hotmail cannot support margins.
21+
- These can be especially problematic when added inside of a table in either mail client.
2022

21-
- Outlook cannot support padding, and Hotmail cannot support margins
22-
- Especially problematic when added inside of a table in either mail client
23-
24-
- **Always use _inline _CSS**
2523

24+
- **Always use inline CSS**
2625
- Most webmail clients (outlook.com, yahoo.com, gmail, etc) will strip CSS out when stripping the head and body tags.
2726

28-
- Have to render coding very carefully so it conforms to their already set HTML that you would view the message in.
27+
- Make sure you render coding very carefully so it conforms to the email client's pre-set HTML.
2928

3029
- **Avoid BR, HR, and height tags in your emails**
3130

32-
- Every browser/client has their own default line height and will default to this. most of the time.
31+
- Every browser/client has their own default line height and will default to this. most of the time.
3332
- Work around in next bullet point below.
3433

34+
3535
- **Use Tables to create general layout of email**
3636

37-
- Be sure that you set the width of each cell in the table
37+
- Set the width of each cell in the table.
38+
39+
- Avoid cell spacing and padding.
3840

39-
- Try to avoid cellspacing and padding
4041
- **Always set a "doctype" in your code**
4142
- **Set wrapper reset styles in "wrapper div"**
4243

4344
- This can override a browser or client's default styling of certain elements.
44-
- For more info - http://meyerweb.com/eric/thoughts/2007/05/01/reset-reloaded/
45+
- Click [here](http://meyerweb.com/eric/thoughts/2007/05/01/reset-reloaded/) for more information on reset styles.
46+
47+
4548
- **Be aware of text and font changes per device (mobile especially) and browsers**
4649

47-
- Mobile devices and different browsers may change the font styling to increase readability
48-
- ie. comic sans not supported on mobile devices
50+
- Mobile devices and different browsers may change the font styling to increase readability.
51+
- For example, comic sans not supported on mobile devices.
4952

5053
## Backgrounds
5154

5255
- **Use the older more basic background HTML tags**
5356

5457
- "background-image" ; "bgcolor" ; "background"
5558
- Many browsers and clients experience issues when trying to support compound CSS values so be sure to use individual values such as "background-image" and "background-repeat"
59+
60+
5661
- **Always offer reset background colors or fall back background colors to defer to if your specific background isn't supported**
5762

5863
## Images
5964

60-
- **Always avoid PNG images ->** Try to always use either JPEG or GIF images
65+
- **Always avoid PNG images** - Try to always use either JPEG or GIF images
6166
- **Always provide image dimensions**
6267

63-
- some clients will automatically apply their own if none are given which can lead to major issues when rendering these images in relation to spacing and alignment.
68+
- Some mail clients will automatically apply their own if none are given which can lead to major issues when rendering these images in relation to spacing and alignment.
6469

65-
- it is important to note however that some mail clients will do this regardless as a default setting
66-
- **Make sure to give ALL of your images 'alt' attributes**
70+
- It is important to note however that some mail clients will do this regardless as a default setting.
6771

68-
- This simple step will keep the overall sizing of your images the same across platforms
69-
- ie. http://www.w3schools.com/tags/att\_img\_alt.asp
72+
- **Make sure to give ALL of your images 'alt' attributes** - This simple step will keep the overall sizing of your images the same across platforms.
73+
7074
- **Outlook.com adds some pixels at the end of each image which can rearrange spacing, alignment, or padding**
7175

72-
- Use the "Outlook.com hack"
73-
74-
- img {display:block;}
75-
- This removes the padding in outlook.com and gives predictable results across many other email clients in terms of added spacing or padding to images.
76-
- **Avoid 'float' tags**
76+
- Use the "Outlook.com hack" - `img {display:block;}`. This removes the padding in outlook.com and gives predictable results across many other email clients in terms of added spacing or padding to images.
7777

78-
- Outlook cannot support these tags
79-
- Instead use 'align'
8078

81-
- ie. `<img src="image.jpeg" align="right">`
82-
- _Seeing issues with Yahoo! as well in this respect?_
79+
- **Avoid 'float' tags**
8380

84-
- Try align="top" to the image in question.
81+
- Outlook cannot support these tags, so SendGrid recommends using align tags. For example, `<img src="image.jpeg" align="right">`.
82+
83+
- Yahoo! has similar issues, so SendGrid recommends using align="top" for the image in question.
8584

8685

8786
## Controlling converted plain text email output
8887

89-
_To control the output of plain-text conversion do one of the following:_
90-
91-
* Turn off the filters causing the conversion from plain text to HTML.
92-
* Start each line with a space, this will add a "preformatted" `<pre>` tag around the line.
93-
* Separate new sentences with double newlines, which will add a "paragraph" `<p>` tag around the sentence.
94-
* Convert your message to HTML, bypassing our need to convert it altogether.
88+
*To control the output of plain-text conversion do one of the following:*
9589

96-
- To disable conversion globally, click **Mail Settings** and select **Plain Content** and enable the suppression.
90+
1. Turn off the filters causing the conversion from plain text to HTML.
91+
1. Start each line with a space, this will add a "preformatted" `<pre>` tag around the line.
92+
1. Separate new sentences with double newlines, which will add a "paragraph" `<p>` tag around the sentence.
93+
1. Convert your message to HTML, bypassing our need to convert it altogether.
94+
1. To disable conversion globally, click **Mail Settings** and select **Plain Content** and enable the suppression.
9795

9896
**Why can't you just automatically add `<br />` tags to newlines upon conversion?**
9997

content/docs/ui/sending-email/warming-up-an-ip-address.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ IP warming is the practice of gradually increasing the volume of mail sent with
1919

2020
When an ISP observes email suddenly coming from a new or "cold" IP address, they will take notice and immediately begin evaluating the traffic coming from that IP. Since ISPs treat email volume as a key determining factor when detecting spam, it is best to begin sending a low to moderate volume, eventually working your way up to larger volumes. This gives the receiving email providers a chance to closely observe your sending habits and record how your recipients engage with your email.
2121

22-
A gradual warm-up does not always guarantee a perfect sending reputation. It is still important to follow sending [best practices](https://sendgrid.com/blog/10-tips-to-keep-email-out-of-the-spam-folder/).
22+
A gradual warmup does not always guarantee a perfect sending reputation. It is still important to follow sending [best practices](https://sendgrid.com/blog/10-tips-to-keep-email-out-of-the-spam-folder/).
2323

2424
<call-out>
2525

0 commit comments

Comments
 (0)