Dialogflow Gateway SEO

README.md

@@ -23,46 +23,39 @@ The development of this project was made possible by [me](https://linkedin.com/i
 - Rich-component and Webhook Support
 - Based on Vue, Webpack 4, Babel 7
 - Integrated Component API (means, you can build the UI from different sources, not only Dialogflow Gateway, but your own APIs as well)
+- Can run in iframe ([demo](https://codepen.io/mishushakov/pen/ywWaRW))
 - Lightweight (without polyfills and fonts the build shrinks down to 100 KB)
 - Free and Documented (documentation coverage at least 80%)
 - Made in Germany (if it makes any sense to you)
 
 For more features and benefits see [this spreadsheet](https://docs.google.com/spreadsheets/d/1Pfpt1JxwlqIxD646p4LVX4okKKVtfvYMBJmPvsUhfgM/edit?usp=sharing)
 
-## Comparisons
-
-Dialogflow Web Demo
-
-- The dialogflow Web Demo, does what it says, but no more. It may be a good fit for a demo, but by no means a production suite and a valuable tool
-
-No more words, [IT'S A DEMO-TIME NOW](https://i.ushakov.co/dialogflow-web-v2)
-
 # Getting started
 
 ## Requirements
 - NodeJS
 - NPM or Yarn
 - Basic knowledge in ES6 (JavaScript)
-- Google Account and Dialogflow V2-Enabled App (if you look for V1, please use my [old repo](https://github.com/mishushakov/dialogflow-web))
+- Google Account and Dialogflow V2 Agent (if you look for V1, please use my [old repo](https://github.com/mishushakov/dialogflow-web) and the [instructions](https://github.com/mishushakov/dialogflow-web/blob/21ffc7017f1a4d51eabb1122c5aae119a7d73587/README.md))
 
 ## Setting Up Dialogflow Gateway
 
 Dialogflow Gateway is a cloud-based service, which connects Dialogflow V2 Agents to the World Wide Web.
-Dialogflow for Web v2 requires Dialogflow Gateway for its formatting option and to make secure and authenthicated requests to Dialogflow V2 API
+Dialogflow for Web v2 requires Dialogflow Gateway for its formatting option and to make secure and authenticated requests to Dialogflow V2 API
 
 Go to the [Dialogflow Gateway Console](https://dialogflow-gateway.ushakov.co/console)
 
 And you will see the following Sign In screen:
 
 ![](https://i.imgur.com/bse2Akc.png)
 
-**Note**: for some adblocks, the Google Sign-In button is not being displayed. Please disable your adblock, if you have the issue
+**Note**: some adblocks hide the Google Sign-In button. Please disable your adblock, if you experience the issue
 
 Press on the "Sign in with Google" button and you will see similar account picker:
 
 ![](https://i.imgur.com/6kjJPPR.png)
 
-Choose your account you used to create your Dialogflow Agent with
+Choose the account, you used to create your Dialogflow Agent with
 
 **Note**: Some browsers (like Safari in my case) block popups. Please allow popups on the website and log in and out again in order to proceed
 
@@ -72,11 +65,11 @@ And you will then see the next popup:
 
 This may happen, because Google need to verify my app (if it hasn't yet). You can still continue by pressing on "Advanced" and "Go to Dialogflow Gateway (unsafe)"
 
-Then you will see another popup once again:
+Then you will see another page:
 
 ![](https://i.imgur.com/jHErXqd.png)
 
-Press on "Allow" in order to allow the application to access your Google Cloud. Google Cloud is needed for following reasons:
+Press on "Allow" in order to allow the application to access your Google Cloud. Google Cloud is used for following reasons:
 
 - Listing your Google Cloud Projects
 - Listing IAM Policies for projects
@@ -90,23 +83,25 @@ When you are ready with this, you will see the console:
 
 **Note**: because of high latency of Google's servers, sometimes linked projects are not displayed as linked. Please reload the page, if the issue occurs
 
-**Note**: Non-Dialogflow-V2 Projects will not link, doesn't matter how hard you will try
+**Note**: non-Dialogflow-V2 Projects will not link, no matter how hard you try
+
+**Note**: you will not see your projects, if you have not allowed popups and finished the previous step
 
 ![](https://i.imgur.com/AEFdvaH.png)
 
-In this list, you will see your Google Cloud Projects.
+This list shows your Google Cloud Projects.
 
 In order to link your Dialogflow Agent to Dialogflow Gateway, press on "Link" button, on the associated Google Cloud project.
 
-The process may take a couple seconds to finish, so be patient. When its finished, the link icon will turn green and you will see the "Manage" button instead of "Link".
+The process may take a couple seconds to finish, so be patient. When its finished, the link icon will turn green and you will see the "Manage" button.
 
-Then, press on "Manage" Button and you will see this view:
+Then, press on the "Manage" Button and you will see this view:
 
 ![](https://i.imgur.com/G8fHU4l.png)
 
 Save the Gateway URL, because we will need it for later
 
-The UI URL is for the managed version of Dialogflow for Web v2, it's used for thoose, who want it to just work (for example for iframe) without additional steps, described below
+The UI URL is for the managed version of Dialogflow for Web v2, for people, who just want it to work (for example in iframe) without additional steps, described below
 
 Optionally, you can also change your Gateway Settings:
 
@@ -118,7 +113,7 @@ You can also specify the sources, which the formatting option will respect. The
 
 You can also unlink the project from Dialogflow Gateway service
 
-**Note**: Unlinking your project, will not remove the service account keys and reset IAM Policies, you will have to do it yourself (if you want to). Also note, that unlinking your project will not reset the quota
+**Note**: Unlinking your project, does not remove the service account keys and reset IAM Policies, you have to do it yourself (if you want to). Also note, that unlinking your project does not reset the quota or unblock the project
 
 ## Cloning the repository to your machine