docs: Update spicepy SDK docs

website/docs/sdks/python/index.md

@@ -12,10 +12,12 @@ https://github.com/spiceai/spicepy
 ### Install
 
 ```shell
-pip install git+https://github.com/spiceai/spicepy@v2.0.0
+pip install git+https://github.com/spiceai/spicepy@v3.0.0
 ```
 
-### Connect to spice runtime
+### Connect to a local Spice Runtime
+
+By default, the Python SDK will connect to a locally running Spice Runtime:
 
 ```python
 from spicepy import Client
@@ -29,18 +31,67 @@ data = client.query(
 pd = data.read_pandas()
 ```
 
-Or pass custom flight address:
+### Connect to Spice Cloud
+
+To connect to Spice Cloud, specify the required Flight and HTTP URLs to connect to Spice Cloud:
+
+```python
+from spicepy import Client
+from spicepy.config import (
+  DEFAULT_FLIGHT_URL,
+  DEFAULT_HTTP_URL
+)
+
+client = Client(
+  api_key="<YOUR SPICE CLOUD API KEY>",
+  flight_url=DEFAULT_FLIGHT_URL,
+  http_url=DEFAULT_HTTP_URL
+)
+
+data = client.query(
+  'SELECT trip_distance, total_amount FROM taxi_trips ORDER BY trip_distance DESC LIMIT 10;',
+  timeout=5*60
+)
+pd = data.read_pandas()
+```
+
+### Connect to a remote Spice Runtime
+
+By specifying a custom Flight and HTTP URL, the Python SDK can connect to a remote Spice Runtime - for example, a centralised Spice Runtime instance.
+
+Example code:
 
 ```python
 from spicepy import Client
 
 client = Client(
-  flight_url="grpc://my_remote_spice_instance:50051"
+  flight_url="grpc://your-remote-spice-runtime-host:50051",
+  http_url="http://your-remote-spice-runtime-host:8090"
 )
 
 data = client.query(
   'SELECT trip_distance, total_amount FROM taxi_trips ORDER BY trip_distance DESC LIMIT 10;',
   timeout=5*60
 )
 pd = data.read_pandas()
-```
+```
+
+### Refresh an accelerated dataset
+
+The SDK supports refreshing an accelerated dataset with the `Client.refresh_dataset()` method. Refresh a dataset by calling this method on an instance of an SDK client:
+
+```python
+from spicepy import Client, RefreshOpts
+
+client = Client()
+
+client.refresh_dataset("taxi_trips", None) # refresh with no refresh options
+client.refresh_dataset("taxi_trips", RefreshOpts(refresh_sql="SELECT * FROM taxi_trips LIMIT 10")) # refresh with overridden refresh SQL
+
+# RefreshOpts support all refresh parameters
+RefreshOpts(
+  refresh_sql="SELECT * FROM taxi_trips LIMIT 10",
+  refresh_mode="full",
+  refresh_jitter_max="1m"
+)
+```