PYTHON-1254: Update Getting Started guide to include Astra connection example

Author: aboudreault

docs/getting_started.rst

@@ -3,16 +3,42 @@ Getting Started
 
 First, make sure you have the driver properly :doc:`installed <installation>`.
 
-Connecting to Cassandra
+Connecting to a Cluster
 -----------------------
 Before we can start executing any queries against a Cassandra cluster we need to setup
 an instance of :class:`~.Cluster`. As the name suggests, you will typically have one
 instance of :class:`~.Cluster` for each Cassandra cluster you want to interact
 with.
 
-The simplest way to create a :class:`~.Cluster` is like this:
 First, make sure you have the Cassandra driver properly :doc:`installed <installation>`.
 
+Connecting to Astra
++++++++++++++++++++
+
+If you are a DataStax `Astra <https://www.datastax.com/products/datastax-astra>`_ user,
+here is how to connect to your cluster:
+
+1. Download the secure connect bundle from your Astra account.
+2. Connect to your cluster with
+
+.. code-block:: python
+
+    from cassandra.cluster import Cluster
+    from cassandra.auth import PlainTextAuthProvider
+
+    cloud_config = {
+        'secure_connect_bundle': '/path/to/secure-connect-dbname.zip'
+    }
+    auth_provider = PlainTextAuthProvider(username='user', password='pass')
+    cluster = Cluster(cloud=cloud_config, auth_provider=auth_provider)
+    session = cluster.connect()
+
+See `Astra <https://docs.datastax.com/en/astra/aws/doc/index.html>`_ and :doc:`cloud` for more details.
+
+Connecting to Cassandra
++++++++++++++++++++++++
+The simplest way to create a :class:`~.Cluster` is like this:
+
 .. code-block:: python
 
     from cassandra.cluster import Cluster
@@ -52,6 +78,8 @@ To establish connections and begin executing queries we need a
     cluster = Cluster()
     session = cluster.connect()
 
+Session Keyspace
+----------------
 The :meth:`~.Cluster.connect()` method takes an optional ``keyspace`` argument
 which sets the default keyspace for all queries made through that :class:`~.Session`:
 
@@ -60,7 +88,6 @@ which sets the default keyspace for all queries made through that :class:`~.Sess
     cluster = Cluster()
     session = cluster.connect('mykeyspace')
 
-
 You can always change a Session's keyspace using :meth:`~.Session.set_keyspace` or
 by executing a ``USE <keyspace>`` query:
 
@@ -70,6 +97,8 @@ by executing a ``USE <keyspace>`` query:
     # or you can do this instead
     session.execute('USE users')
 
+Execution Profiles
+------------------
 Profiles are passed in by ``execution_profiles`` dict.
 
 In this case we can construct the base ``ExecutionProfile`` passing all attributes: