update README

Author: dsinghvi

.fernignore

@@ -1 +1,4 @@
 # Specify files that shouldn't be modified by Fern
+
+README.md
+assets/

README.md

@@ -1,53 +1,114 @@
-<!-- Begin Title, generated by Fern  -->
 # Webflow Python Library
 
 [![fern shield](https://img.shields.io/badge/%F0%9F%8C%BF-SDK%20generated%20by%20Fern-brightgreen)](https://github.com/fern-api/fern)
 
-The Webflow Python Library provides convenient access to the Webflow API from applications written in Python.
-<!-- End Title  -->
+The Webflow Python Library provides convenient access to the Webflow API from 
+applications written in Python. The library includes type definitions for all 
+request and response fields, and offers both synchronous and asynchronous clients powered by httpx.
 
-<!-- Begin Installation, generated by Fern  -->
-# Installation
+## Documentation
 
-```sh
-pip install --upgrade webflow
+API reference documentation is available [here](https://docs.metriport.com/home/welcome).
+
+## Installation
+
+Add this dependency to your project's build file:
+
+```bash
+pip install webflow
+# or
+poetry add webflow
 ```
-<!-- End Installation  -->
 
-<!-- Begin Usage, generated by Fern  -->
-# Usage
+## Usage
+Simply import `Webflow` and start making calls to our API. 
 
 ```python
 from webflow.client import Webflow
 
-client = Webflow(
-    access_token="YOUR_ACCESS_TOKEN",
-)
+client = Webflow(access_token="YOUR_ACCESS_TOKEN")
+site = client.sites.get("site-id")
 ```
-<!-- End Usage  -->
 
-<!-- Begin Async Usage, generated by Fern  -->
-# Async Client
+## Async Client
+The SDK also exports an async client so that you can make non-blocking
+calls to our API. 
 
 ```python
 from webflow.client import AsyncWebflow
 
 client = AsyncWebflow(
     access_token="YOUR_ACCESS_TOKEN",
 )
+
+async def main() -> None:
+    site = await client.sites.get("site-id")
+    print("Received site", site)
+
+asyncio.run(main())
 ```
-<!-- End Async Usage  -->
 
-<!-- Begin Status, generated by Fern  -->
-# Beta Status
+## Webflow Module
+All of the models are nested within the Webflow module. Let Intellisense 
+guide you! 
+
+![Alt text](assets/module.png)
+
+## Exception Handling
+All errors thrown by the SDK will be sublcasses of [`ApiError`](./src/webflow/core/api_error.py).
+
+```python
+import webflow
+
+try:
+  client.sites.get(...)
+except webflow.core.ApiError as e: # Handle all errors
+  print(e.status_code)
+  print(e.body)
+except webflow.BadRequestError as e: # Handle specific error
+  print(e.status_code)
+  print(e.body)
+```
+
+## Advanced
+
+### Timeouts
+By default requests time out after 60 seconds. You can configure this with a 
+timeout option, which accepts a float.
+
+```python
+from webflow.client import Webflow
+
+client = Webflow(
+    # 20 seconds
+    timeout=20.0,
+)
+```
+
+### Custom HTTP client
+You can override the httpx client to customize it for your use case. Some common usecases 
+include support for proxies and transports.
+
+```python
+import httpx
+
+from webflow.client import Webflow
+
+client = Webflow(
+    http_client=httpx.Client(
+        proxies="http://my.test.proxy.example.com",
+        transport=httpx.HTTPTransport(local_address="0.0.0.0"),
+    ),
+)
+```
+
+## Beta Status
 
 This SDK is in beta, and there may be breaking changes between versions without a major 
 version update. Therefore, we recommend pinning the package version to a specific version. 
 This way, you can install the same version each time without breaking changes.
-<!-- End Status  -->
 
-<!-- Begin Contributing, generated by Fern  -->
-# Contributing
+## Contributing
 
 While we value open-source contributions to this SDK, this library is generated programmatically. 
 Additions made directly to this library would have to be moved over to our generation code, 
@@ -56,5 +117,3 @@ otherwise they would be overwritten upon the next generated release. Feel free t
 an issue first to discuss with us!
 
 On the other hand, contributions to the README are always very welcome!
-<!-- End Contributing  -->
-