docs: update getting started with hasura cloud (close #5206) (#5208)

CHANGELOG.md

@@ -9,6 +9,7 @@
 - server: add new `--conn-lifetime` and `HASURA_GRAPHQL_PG_CONN_LIFETIME` options for expiring connections after some amount of active time (#5087)
 - server: shrink libpq connection request/response buffers back to 1MB if they grow beyond 2MB, fixing leak-like behavior on active servers (#5087)
 - docs: add note for managed databases in postgres requirements (close #1677, #3783) (#5228)
+- docs: add hasura cloud to getting started section (close #5206) (#5208)
 
 
 ## `v1.3.0-beta.3`

docs/graphql/manual/deployment/heroku/index.rst

@@ -15,7 +15,7 @@ Run Hasura GraphQL engine on Heroku
 This guide will help you get the Hasura GraphQL engine running as a "git push to deploy" app on
 `Heroku <https://www.heroku.com/platform>`_ and connecting it to a `Heroku Postgres <https://www.heroku.com/postgres>`_
 instance. If you want a simple, quick deployment on Heroku, follow this :ref:`Heroku quickstart
-guide <heroku_simple>`.
+guide <heroku_quickstart>`.
 
 Clone the Hasura GraphQL engine Heroku app
 ------------------------------------------

docs/graphql/manual/deployment/index.rst

@@ -24,6 +24,7 @@ The Hasura GraphQL engine is a binary that is shipped as a Docker container.
 
 Choose from the following guides to deploy the Hasura GraphQL engine and connect it to a Postgres database:
 
+- `Deploy using Hasura Cloud <https://hasura.io/docs/cloud/1.0/manual/getting-started/index.html>`__
 - :ref:`Deploy using Heroku <deploy_heroku>`
 - :ref:`Deploy using Docker <deployment_docker>`
 - :ref:`Deploy using Kubernetes <deploy_kubernetes>`

docs/graphql/manual/getting-started/index.rst

@@ -26,20 +26,20 @@ To use the Hasura GraphQL engine, you need to:
 Get started from scratch
 ------------------------
 
-- `Using Hasura Cloud <https://hasura.io/docs/cloud/1.0/manual/getting-started/index.html>`_ **(recommended)**: Create a new Hasura Cloud project with just one click.
-- :ref:`Using Heroku <heroku_simple>`: Get started in under 60 seconds with no setup required to
-  host the Hasura GraphQL engine and Postgres on Heroku's free tier.
+- `Using Hasura Cloud <https://hasura.io/docs/cloud/1.0/manual/getting-started/index.html>`__ **(recommended)**: Create a new Hasura Cloud project with just one click.
 - :ref:`Using Docker <docker_simple>`: Run a **local development** setup that sets up both the Hasura GraphQL
   engine and Postgres using Docker.
+- :ref:`Using Heroku <heroku_quickstart>`: Get started quickly with no setup required to
+  host the Hasura GraphQL engine and Postgres on Heroku.
 
 Get started using an existing database
 --------------------------------------
 
-- `Using Hasura Cloud <https://hasura.io/docs/cloud/1.0/manual/projects/create.html>`_ **(recommended)**: Create a new Hasura Cloud project connected to an existing Postgres database
-- :ref:`Using Heroku <heroku_existing_db>`: Run on Heroku using an existing Heroku
-  Postgres database.
+- `Using Hasura Cloud <https://hasura.io/docs/cloud/1.0/manual/projects/create.html>`__ **(recommended)**: Create a new Hasura Cloud project connected to an existing Postgres database.
 - :ref:`Using Docker <deployment_docker>`: Run as a docker container and connect to an existing Postgres
   database.
+- :ref:`Using Heroku <heroku_existing_db>`: Run on Heroku using an existing Heroku
+  Postgres database.
 - :ref:`Using Kubernetes <deploy_kubernetes>`: Run on Kubernetes and connect to an existing Postgres
   database.
 
@@ -52,7 +52,7 @@ Get started using an existing database
    :titlesonly:
    :hidden:
 
-   Heroku quickstart <heroku-simple>
+   Hasura cloud quickstart <https://hasura.io/docs/cloud/1.0/manual/getting-started/index.html>
    Docker quickstart <docker-simple>
    Using an existing database <using-existing-database>
    first-graphql-query

docs/graphql/manual/getting-started/using-existing-database.rst

@@ -14,10 +14,11 @@ Getting started with an existing database
 
 Follow one of these guides to set up Hasura GraphQL engine using an existing database:
 
-- :ref:`Using Heroku <heroku_existing_db>`: Run on Heroku and connect to an existing
-  Heroku Postgres database.
+- `Using Hasura Cloud <https://hasura.io/docs/cloud/1.0/manual/projects/create.html>`__ **(recommended)**: Create a new Hasura Cloud project connected to an existing Postgres database
 - :ref:`Using Docker <deployment_docker>`: Run as a docker container and connect to an existing Postgres
   database.
+- :ref:`Using Heroku <heroku_existing_db>`: Run on Heroku and connect to an existing
+  Heroku Postgres database.
 - :ref:`Using Kubernetes <deploy_kubernetes>`: Run on Kubernetes and connect to an existing Postgres
   database.
 

docs/graphql/manual/guides/deployment/heroku-quickstart.rst

@@ -2,16 +2,19 @@
    :description: Get started with Hasura using Heroku
    :keywords: hasura, docs, start, heroku
 
-.. _heroku_simple:
+.. _heroku_quickstart:
 
-Quickstart with Heroku
-======================
+One-click deployment with Heroku
+================================
 
 .. contents:: Table of contents
   :backlinks: none
   :depth: 1
   :local:
 
+Introduction
+------------
+
 This guide will help you get the Hasura GraphQL engine and Postgres running on `Heroku's free tier <https://www.heroku.com/free>`_.
 It is the easiest and fastest way of trying out Hasura.
 
@@ -33,7 +36,7 @@ Click the button below to deploy to Heroku:
    If you don't have an account on Heroku, you need to sign up on Heroku. You won't need a credit card, and once you
    sign up you'll be redirected to your Heroku app creation page automatically.
 
-.. thumbnail:: /img/graphql/manual/getting-started/heroku-app.png
+.. thumbnail:: /img/graphql/manual/guides/heroku-app.png
    :alt: Deploy to Heroku 
 
 Note that **Heroku's free Postgres add-on** is also automatically provisioned!
@@ -44,7 +47,7 @@ Open the Hasura console
 That's it!  Head to ``https://<YOUR_HEROKU_APP>.herokuapp.com`` and open your app.
 You should see the Hasura console.
 
-.. thumbnail:: /img/graphql/manual/getting-started/heroku-app-deployed.png
+.. thumbnail:: /img/graphql/manual/guides/heroku-app-deployed.png
    :alt: Open the Hasura console
 
 Hello World (GraphQL or event triggers)

docs/graphql/manual/guides/deployment/index.rst

@@ -12,6 +12,8 @@ Guides: Deployment
   :depth: 1
   :local:
 
+- `One-click deployment with Hasura Cloud <https://hasura.io/docs/cloud/1.0/manual/getting-started/index.html>`__
+- :ref:`One-click deployment with Heroku <heroku_quickstart>`
 - :ref:`Digital Ocean One-click App on Marketplace <deploy_do_marketplace>`
 - :ref:`Azure Container Instances with Postgres <deploy_azure_ci_pg>`
 - :ref:`Google Cloud Platform with Kubernetes engine and Cloud SQL <deploy_gc_kubernetes>`
@@ -28,6 +30,7 @@ Guides: Deployment
    :titlesonly:
    :hidden:
 
+   Heroku One-click deployment <heroku-quickstart>
    DigitalOcean One-click App on Marketplace <digital-ocean-one-click>
    Azure Container Instances with Postgres <azure-container-instances-postgres>
    Google Cloud Platform with Kubernetes engine and Cloud SQL <google-kubernetes-engine-cloud-sql>