docs: Update Hosting a FastStore + VTEX website doc (#1329)

* docs: Update Hosting a FastStore + VTEX website doc * docs: update secure subdomain docs
vtex · May 30, 2022 · 4663c04 · 4663c04 · vercel · May 30, 2022
1 parent c4c05d4
commit 4663c04
Show file tree

Hide file tree

Showing 7 changed files with 103 additions and 18 deletions.
diff --git a/apps/docs/blog/2022-05-30-faststore.md b/apps/docs/blog/2022-05-30-faststore.md
@@ -0,0 +1,19 @@
+---
+description: Check the recent changes in the secure subdomain configuration.
+tags: [faststore]
+hide_table_of_contents: false
+---
+
+# Changes in the secure subdomain configuration
+
+We've recently changed the configurations needed for the  `secure` subdomain. Hence, if you come across the **"This connection is not private"** error while trying to complete an order at your store website, check if your website's secure subdomain is pointing to `secure.{hostname}.cdn.vtex.com`, where `{hostname}` is the **complete** address of your store.
+
+![](https://vtexhelp.vtexassets.com/assets/docs/src/not-secure___d8621c4ec4766fde0206c32055a2975d.jpeg)
+
+## What has changed?
+
+The `secure` subdomain must now point to  `secure.{hostname}.cdn.vtex.com`, where `{hostname}` is the **complete** address of your store. Before, the `secure` subdomain was being pointed to `{account}.vtexcommercestable.com.br`.
+
+## What needs to be done?
+
+If you come across the **"This connection is not private"** error in your store website, repeat the [Hosting a FastStore + VTEX website](/how-to-guides/platform-integration/vtex/hosting-a-faststore-vtex-website) guide, making sure that the `secure` subdomain is pointing to `secure.{hostname}.cdn.vtex.com`.
diff --git a/...ocs/how-to-guides/platform-integration/vtex/hosting-a-faststore-vtex-website.md b/...ocs/how-to-guides/platform-integration/vtex/hosting-a-faststore-vtex-website.md
@@ -21,21 +21,31 @@ By the end of these steps, you'll host your FastStore website on the internet. H
 
 ### Step 1 - Configuring your website domain
 
-To make your website publicly available, you need to configure a domain that points to the IP address where your store is hosted. 
+Take the following steps to make your website publicly available:
 
-:::info
-To see which IP address corresponds to your store website (`{account}.vtex.app`), use the `nslookup` command as in the following:
+1. Configure a domain that points to the **IP address** where your store is hosted. Notice that, depending on which domain provider you use, the steps to configure your website domain may vary. *See the documentation of your domain provider for more information.*
 
-1. Open the terminal.
-2. Enter `nslookup {account}.vtex.app` (e.g., `nslookup base.vtex.app`).
-3. Hit Enter. 
+   :::info
+   To see which **IP address** corresponds to your store website (`{account}.vtex.app`), use the `nslookup` command as in the following:
 
-Now look below the `Non-authoritative answer` message to see the IP addresses capable of hosting your website. 
-:::
+   1. Open the terminal.
+   2. Enter `nslookup {account}.vtex.app` (e.g., `nslookup base.vtex.app`).
+   3. Hit Enter. 
 
-You must also add a subdomain called `secure` pointing to `{account}.vtexcommercestable.com.br`. This will allow the **Checkout**, **Order Placed**, **Login**, and **My Account** pages to work under that subdomain.
+   Now look below the `Non-authoritative answer` message to see the IP addresses capable of hosting your website. 
+   :::
 
-Notice that depending on which domain provider you use, the steps to configure your website domain may vary. *See the documentation of your domain provider for more information.*
+2. Add a subdomain called `secure` (`secure.{domain}.com`) pointing to `secure.{hostname}.cdn.vtex.com`. This subdomain will be used by the **Checkout**, **Order Placed**, **Login**, and **My Account** pages.
+   - *Assume that `{hostname}` is the **complete** address of your store.*
+
+Take the following example:
+
+```
+Store address: secure.mystore.com.br
+  - Entry (subdomain): secure
+  - Type: CNAME
+  - Destination: secure.mystore.com.br.cdn.vtex.com
+```
 
 ### Step 2 - Setting up your VTEX account
 
@@ -92,3 +102,10 @@ To provide shoppers with a full checkout and post-purchase experience, make sure
 1. [Integrating your FastStore project with VTEX Login](/how-to-guides/platform-integration/vtex/integrating-the-vtex-login).
 2. [Integrating your FastStore project with VTEX Checkout](/how-to-guides/platform-integration/vtex/integrating-vtex-checkout).
 3. [Integrating your FastStore project with VTEX Order Placed and My Account](/how-to-guides/platform-integration/vtex/integrating-vtex-orderplaced-myaccount).
+
+---
+
+## Related resources
+
+- [Setting up DNS pointing to VTEX](https://help.vtex.com/en/tutorial/configuring-dns-pointing-to-vtex--tutorials_4280)
+- [How to insert a reverse proxy in front of VTEX services](https://help.vtex.com/en/tutorial/how-to-insert-a-reverse-proxy-in-front-of-vtex-services)
diff --git a/apps/docs/docs/how-to-guides/platform-integration/vtex/troubleshooting.md b/apps/docs/docs/how-to-guides/platform-integration/vtex/troubleshooting.md
@@ -0,0 +1,18 @@
+---
+sidebar_label: Troubleshooting
+description: Troubleshoot errors that have already tricked other FastStore users while integrating their projects with the VTEX platform
+---
+
+# Troubleshooting - VTEX integration
+
+While integrating your FastStore project with the VTEX platform, you may come across common errors that have already tricked other FastStore users. This article is intended to help you troubleshoot some of these issues.
+
+## Error - “Your connection is not private”
+
+You may find the following error after trying to complete a purchase in your store:
+
+![](https://vtexhelp.vtexassets.com/assets/docs/src/not-secure___d8621c4ec4766fde0206c32055a2975d.jpeg)
+
+**Cause:** This error occurs when your browser is unable to verify whether a website is safe to visit. This usually happens when the browser notices a problem while creating an SSL connection or can’t verify the certificate. 
+
+**Solution:** Follow the [**Hosting a FastStore + VTEX website**](/how-to-guides/platform-integration/vtex/hosting-a-faststore-vtex-website#step-2---setting-up-your-vtex-account) guide. If the issue persists, check if the `secure` subdomain of your website is pointing to `secure.{hostname}.cdn.vtex.com`, where `hostname` is the complete address of your store.
diff --git a/apps/docs/docs/tutorials/cms/Troubleshooting.md b/apps/docs/docs/tutorials/cms/Troubleshooting.md
@@ -1,8 +1,9 @@
 ---
 description: Troubleshoot errors that have already tricked other FastStore users throughout the VTEX Headless CMS integration.
+sidebar_label: Troubleshooting
 ---
 
-# Troubleshooting 
+# Troubleshooting - VTEX Headless CMS integration 
 
 Throughout this tutorial, you may come across common errors that have already tricked other FastStore users. This article is intended to help you troubleshoot some of these issues.
 

diff --git a/apps/docs/docs/tutorials/gatsby/Troubleshooting.mdx b/apps/docs/docs/tutorials/gatsby/Troubleshooting.mdx
@@ -1,4 +1,8 @@
-# Troubleshooting
+---
+sidebar_label: Troubleshooting
+---
+
+# Troubleshooting - Creating storefronts with Gatsby
 
 Throughout this tutorial, you may come across common errors that have already tricked other FastStore users. This article is intended to help you troubleshoot some of these issues.
 

diff --git a/apps/docs/static/data/doc-update.json b/apps/docs/static/data/doc-update.json
@@ -1,4 +1,30 @@
 [
+  {
+    "date": "2022-05-30",
+    "type": "Added",
+    "menu": "How-to Guides",
+    "category": "Platform Integration",
+    "path": "/how-to-guides/platform-integration",
+    "docs": [
+      {
+        "path": "/how-to-guides/platform-integration/vtex/troubleshooting",
+        "title": "Troubleshooting - VTEX integration"
+      }
+    ]
+  },
+  {
+    "date": "2022-05-30",
+    "type": "Fixed",
+    "menu": "How-to Guides",
+    "category": "Platform Integration",
+    "path": "/how-to-guides/platform-integration",
+    "docs": [
+      {
+        "path": "/how-to-guides/platform-integration/vtex/hosting-a-faststore-vtex-website",
+        "title": "Hosting a FastStore + VTEX website"
+      }
+    ]
+  },
   {
     "date": "2022-05-17",
     "type": "Added",

diff --git a/apps/docs/static/data/releases.json b/apps/docs/static/data/releases.json
@@ -1,4 +1,10 @@
 [
+  {
+    "title": "Changes in the secure subdomain configuration",
+    "product": "FastStore",
+    "fileName": "2022-05-30-faststore",
+    "description": "Check the recent changes in the secure subdomain configuration."
+  },
   {
     "title": "Required action for VTEX Headless CMS users",
     "product": "CMS",
@@ -16,11 +22,5 @@
     "product": "FastStore",
     "fileName": "2022-05-18-faststore",
     "description": "The FastStore API types, queries and mutations have been documented. You can check it now by using GraphiQL."
-  },
-  {
-    "title": "Faster builds with new WebOps caching system",
-    "product": "WebOps",
-    "fileName": "2022-05-11-webops",
-    "description": "FastStore projects deployed with WebOps can now benefit from faster builds as WebOps can now reuse outputs produced from previous builds."
   }
 ]