Skip to content

Commit 405152c

Browse files
committed
Fix (doc): Update grammar and formatting errors
1 parent 5f99b6a commit 405152c

File tree

1 file changed

+25
-27
lines changed

1 file changed

+25
-27
lines changed

linode/buy_domain.md

Lines changed: 25 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -23,15 +23,15 @@ In the search bar, find yourself a domain name that you want to register. You ma
2323

2424
I will search for _bolderlearner.com_. If it is available, I will add it to my cart. You will find the name with possible other extensions such as _.net_ or _.academy_. Pick the one that is most appropriate for your application. Namecheap normally offers monthly discounts when you register a domain name. Be sure to check that out and take advantage of the discount.
2525

26+
![Purchase domain](/images/linode/buy_domain/purchase.png)
27+
2628
Once the name is in my cart, I will click in the checkout button to begin the process of confirming my order. I will register this domain for one year. You can choose to register it for longer periods of time by clicking the dropdown menu and selecting the number of years you would like to register the domain for.
2729

28-
By default, domain privacy is enabled just to protect you and your information when you register a domain. You can disable this by clicking the privacy buttons, but I don't know why you'd want to do that. There is a linux terminal command that you can use to find out more information about a domain name. So, for example, if I want to find out more information about _bolderlearner.com_, I can run the command `whois bolderlearner.com`. This simple command will reveal all the information about the domain name. If your domain privacy is disabled, all your personal details will be visible to anyone who runs this command. However, since the domain privacy is enabled by default, I am not be concerned about this since everything about me is blocked.
30+
By default, domain privacy is enabled just to protect you and your information when you register a domain. You can disable this by clicking the privacy buttons, but I don't know why you'd want to do that. There is a linux terminal command that you can use to find out more information about a domain name. So, for example, if I want to find out more information about _bolderlearner.com_, I can run the command `whois bolderlearner.com`. This simple command will reveal all the information about the domain name. If your domain privacy is disabled, all your personal details will be visible to anyone who runs this command. However, since the domain privacy is enabled by default, I am not be concerned about this because everything about me is blocked.
2931

30-
Namecheap also offers other addons such as SSL, VPN, Professional Email, and more. I will not be using any of these addons because I can do them myself. That is all I need to register my domain name. I will proceed to confirm my order. If you are interested in discounts, you will see a Promo Code field. Enter the promo code on offer during the month of your purchase, click "Apply" before clicking "Confirm Order". Since I am not a first time registrant, the coupon shown below will be invalid.
32+
Namecheap also offers other addons such as SSL, VPN, Professional Email, and more. I will not be using any of these addons because I can do them myself. That is all I need to register my domain name. I will proceed to confirm my order. If you are interested in discounts, you will see a Promo Code field. Enter the promo code on offer during the month of your purchase, click "Apply" before clicking "Confirm Order". Since I am not a first time registrant, the coupon shown above will be invalid.
3133

32-
![Purchase domain](/images/linode/buy_domain/purchase.png)
33-
34-
I will be redirected to the billing page where I can enter my credit card information. For this domain, I will disable autorenewal for my purchase. Once that is done, I will click "Continue". Namecheap will then redirect me to a confirmation page just to make sure that the details I have entered are correct. If everything looks good, I will confirm this purchase.
34+
I will be redirected to the billing page where I can enter my credit card information. I have left out an image illustration of the billing page for privacy of my details. For this domain, I will disable autorenewal for my purchase. Once that is done, I will click "Continue". Namecheap will then redirect me to a confirmation page just to make sure that the details I have entered are correct. If everything looks good, I will confirm this purchase.
3535

3636
Back to my namecheap dashboard, I can click the [Domain List](https://ap.www.namecheap.com/domains/list/) link in the sidebar navigational menu to see the domain I just purchased. There is a "Manage" button next the domain. Clicking this button will redirect me to the domain management page.
3737

@@ -47,7 +47,7 @@ To add a new domain, I will make use of the [DNS Manager Documentation](https://
4747

4848
### DNS Set-Up Checklist
4949

50-
1. [Register a domain name](#register-a-domain-name)
50+
1. [Register a domain name](#register-a-domain-name) (completed above)
5151
2. [Set your domain name to use Linode's nameservers](#set-your-domain-name-to-use-linode-s-nameservers)
5252
3. [Use the DNS Manager to add a new record to your domain](#use-the-dns-manager-to-add-a-new-record-to-your-domain)
5353
4. [Set up revers DNS](#set-up-revers-dns)
@@ -71,41 +71,41 @@ I will paste the nameservers into the text boxes then click on the :heavy_check_
7171

7272
![Save nameserver changes](/images/linode/buy_domain/save_nameserver_changes.png)
7373

74-
Both Linode and Namecheap say that the changes I have made will take some time, usually 24 - 48 hours, to take effect. In computer jargon, this is known as a "DNS propagation delay".
74+
Both Linode and Namecheap say that the changes I have made will take some time, usually 24 - 48 hours, for the changes to apply. In computer jargon, this is known as a "DNS propagation delay".
7575

7676
### Use the DNS Manager to Add a New Record to Your Domain
7777

7878
Within my domain list in Linode's dashboard, there is a button called "Create Domain".
7979

8080
![Create domain](/images/linode/buy_domain/create_domain.png)
8181

82-
To add my new domain name, I will click on this button.
82+
To add my new domain name, I will click on this button. I will see this page:
8383

8484
![Create domain in linode](/images/linode/buy_domain/create_domain_in_linode.png)
8585

86-
I have added a temporary email _[email protected]_ which does not exist yet. "Create Domain" button will create this new domain and redirect me to Linode's domain management page.
86+
I have added my domain and a temporary email _[email protected]_ which does not exist yet. "Create Domain" button will create this new domain and redirect me to Linode's domain management page.
8787

8888
![Linode domain management](/images/linode/buy_domain/linode_domain_management.png)
8989

9090
At first, this might look very intimidating, but it is actually very simple. What I am interested in here is to add some DNS records to my domain. Example of DNS records are A records, CNAME records, MX records, and TXT records.
9191

92-
The first record that I am going to add is an A record. This record is used to point my domain name to a specific IP address. I will use the IP address of my Linode. This record requires the following fields:
92+
The first record that I am going to add is an A record. This record is used to point my domain name to a specific IP address. The IP address in context is the IP address of my Linode. This record requires the following fields:
9393

9494
- `Hostname`: This is the domain name that I want to point to my IP address.
9595
- `IP Address`: This is the IP address that I want to point to my domain name.
9696
- `TTL`: This is the time to live of the record. It sets the lifespan of the cache for the DNS record
9797

98-
I will click on "Add an A/AAAA Record" button to update my hostname, IP address, and TTL.
98+
I will click on "Add an A/AAAA Record" button (seen above) to update my hostname, IP address, and TTL.
9999

100100
![A record](/images/linode/buy_domain/a_record.png)
101101

102-
I have added my host name as `www`, my IP address as 212.71.247.241 and I left TTL as it was, that is "Default". The IP address that I am using currently is different from the one you saw in [the previous tutorial](deploy_on_linode.md). This is because I recreated the entire project and obtained a new IP address. Moving forward, I will be using this new IP address.
102+
I have added my host name as `www`, my IP address as _212.71.247.241_ and I left TTL as it was, that is "Default". The IP address that I am using currently is different from the one you saw in [the previous tutorial](deploy_on_linode.md). This is because I recreated the entire project and obtained a new IP address. Moving forward, I will be using this new IP address.
103103

104104
I can add more A records to my domain. Currently, I have only `www` record.
105105

106-
- `Hostname`: for example bolderlearner.com. I want a quick search of this domain, without the `www.` prefix.
107-
- `blog`: so this will be something like blog.bolderlearner.com.
108-
- `*` (asterisk) - this is an example of a wildcard record. It will match any request for domains that do not exist. Wildcards are often used to point all non-existing domains to a specific IP address or top-level domain. If the querried first-level domain does not exist, the IP address specified in the wildcard DNS record will respond. For example, if I search for a non-existent app.bolderlearner.com, I will re-directed to www.bolderlearner.com.
106+
- `Hostname`: in case a user forgest the `www.` prefix.
107+
- `blog`: this will be something like _blog.bolderlearner.com_.
108+
- `*` (asterisk) - this is an example of a wildcard record. It will match any request for domains that do not exist. Wildcards are often used to point all non-existing domains to a specific IP address or top-level domain. If the querried first-level domain does not exist, the IP address specified in the wildcard DNS record will respond. For example, if I search for a non-existent _app.bolderlearner.com_, I will re-directed to www.bolderlearner.com.
109109

110110

111111

@@ -122,7 +122,7 @@ What I am interested in here is the IPv4 address. The first row is the IP addres
122122

123123
![Edit reverse dns](/images/linode/buy_domain/edit_reverse_dns.png)
124124

125-
Only on form field is provided. In my case, I have added my domain name as www.bolderlearner.com. Sometimes it may take a few minutes for the DNS to propagate and it might look like you have an error. Give it a few minutes if that is the case for you. My edit was instant. As soon as you save, you will see that Reverse DNS column has been updated.
125+
Only one form field is provided. In my case, I have added my domain name as www.bolderlearner.com. Sometimes it may take a few minutes for the DNS to propagate and it might look like you have an error. Give it a few minutes if that is the case for you. My edit was instant. As soon as you save, you will see that Reverse DNS column has been updated.
126126

127127
I will open my browser and paste my domain name into the search bar to test if the application is accessible.
128128

@@ -133,48 +133,46 @@ As you can see, I can access my application on www.bolderlearner.com. I have tes
133133

134134
### Add Additional DNS Records
135135

136-
If you are familiar with [Twilio Sendgrid](https://sendgrid.com/), you probably know that it is a cloud-based email service. There is a good chance that using the Flask-mail package may give you authentication and email credibility issues. This package works exceptionally well during testing, but on a live production server, receiving emails may fail. Thankfully, our current setup work find and you do not have to worry about this. I want to show you how you can configure an email service such as SendGrid to work with your new domain name.
136+
If you are familiar with [Twilio Sendgrid](https://sendgrid.com/), you probably know that it is a cloud-based email service. There is a good chance that using the Flask-mail package may give you authentication and email credibility issues. This package works exceptionally well during testing, but on a live production server, receiving emails may fail. Thankfully, our current setup works fine and you do not have to worry about this. I want to show you how you can configure an email service such as SendGrid to work with your new domain name.
137137

138138
This section will show you how to **receive** emails within a Flask application. If you want to learn how you can **send** emails from a Python Flask application, you can check this [other comprehensive tutorial](/twilio_sendgrid.md) to learn more. I recommend that you begin with this tutorial before you can continue.
139139

140-
I need to authenticate my domain name with Twilio SendGrid so that the service can send and receive emails on my behalf. You can check the [Twilio SendGrid documentation](https://docs.sendgrid.com/ui/account-and-settings/how-to-set-up-domain-authentication) to learn more.
141-
142-
First, I need to [login](https://app.sendgrid.com/) to my SendGrid account. Once authenticated, check the sidebar on the left of the dashboard and click on "Settings". You will see a section called "Sender Authentication".
140+
I need to authenticate my domain name with Twilio SendGrid so that the service can send and receive emails on my behalf. First, I need to [login](https://app.sendgrid.com/) to my SendGrid account. Once authenticated, check the sidebar on the left of the dashboard and click on "Settings". You will see a section called "Sender Authentication".
143141

144142
![Sender authentication](/images/linode/buy_domain/sendgrid_sender_authentication.png)
145143

146144
Click on this link to access the Sender Authentication page. There is a button called "Authenticate Your Domain".
147145

148146
![Authenticate Your Domain](/images/linode/buy_domain/authenticate_your_domain_button.png)
149147

150-
There are several questions you will be asked. The first page has two questions. Unfortunately, Linode, my DNS provider, is not listed in the dropdown menu. I needed to click on "Other Hoste (Not Listed)" to provide the host name. I also allowed for link branding in this domain.
148+
There are several questions you will be asked. The first page has two questions. Unfortunately, Linode, my DNS provider, is not listed in the dropdown menu. I needed to click on "Other Host (Not Listed)" to provide the host name. I also allowed for link branding in this domain.
151149

152150
![Authenticate Your Domain Page 1](/images/linode/buy_domain/authenticate_domain_page_1.png)
153151

154-
Click on the "Next" button to continue. You will be required to update the domain name an email can be sent from. A nice little preview of the email is shown as you key in your domain name.
152+
Click on the "Next" button to continue. You will be required to update the domain name from which an email can be sent. A nice little preview of the email is shown as you key in your domain name.
155153

156154
![Authenticate Your Domain Page 2](/images/linode/buy_domain/authenticate_domain_page_2.png)
157155

158-
Finally, I will manually need to add the records seen in page 3 to my domain in Linode. There are five records that I need to add. These records need to be added to the CNAME section within Linode.
156+
Finally, I will need to manually add the records seen in page 3 to my domain in Linode. There are five records that I need to add. These records need to be added to the CNAME section within Linode.
159157

160158
![Authenticate Your Domain Page 3](/images/linode/buy_domain/authenticate_domain_page_3.png)
161159

162160
On my Linode domain, I will scroll down to the CNAME section, click on the "Add a CNAME Record" button, and add the above records.
163161

164162
![CNAME records section](/images/linode/buy_domain/cname_record_section.png)
165163

166-
Below is an example of the CNAME values under the HOST column as they are displayed and how you will need to enter them into your DNS management with one of these providers:
164+
Below is an example of the CNAME values under the HOST column as they are displayed and how you will need to enter them into your DNS management with one of your providers:
167165

168166
- HOST/NAME `em123.yourdomain.com` . ENTER CNAME RECORD HOST/NAME AS: `em123`
169167
- HOST/NAME `s1._domainkey.yourdomain.com` ENTER CNAME RECORD HOST/NAME AS: `s1._domainkey`
170168
- HOST/NAME `s2._domainkey.yourdomain.com` ENTER CNAME RECORD HOST/NAME AS: `s2._domainkey`
171169

170+
![Sendgrid CNAME records](/images/linode/buy_domain/sengrid_cname_record.png)
171+
172172
It can take up to 48 hours for the records to verify after you upload them into your DNS host, so you will likely have to come back later to verify by clicking the "Verify" button. If you click verify, and only half of your CNAME records verify, this usually means that you need to wait a bit longer. It's also possible that you entered one of your records incorrectly.
173173

174174
![Verification error](/images/linode/buy_domain/verification_error.png)
175175

176176
Any time that you send an email with a FROM address whose domain matches the domain set in the domain authentication, SendGrid applies that domain to your email. You only need to update your domain authentication if you want to update the domain you are emailing from.
177177

178-
![Sendgrid CNAME records](/images/linode/buy_domain/sengrid_cname_record.png)
179-
180-
With the edits done in my evironment variables as seen on [the earlier mentioned tutorial](/twilio_sendgrid.md), everything should work just fine.
178+
With the edits done in my evironment variables as seen on [the earlier mentioned tutorial](/twilio_sendgrid.md), everything should work just fine. You can check the [Twilio SendGrid documentation](https://docs.sendgrid.com/ui/account-and-settings/how-to-set-up-domain-authentication) to learn more.

0 commit comments

Comments
 (0)