Merge pull request #1158 from planetlabs/main

add Planet sync client to docs, fix docstring (#1153)

Author: ischneider

docs/python/sdk-reference.md

@@ -38,4 +38,6 @@ title: Python SDK API Reference
     rendering:
       show_root_full_path: false
 
-
+## ::: planet.Planet
+    rendering:
+      show_root_full_path: false

planet/sync/client.py

@@ -16,10 +16,11 @@ class Planet:
     Authentication is required: defaults to detecting API key from environment (PL_API_KEY).
 
     Members:
-    `data`: for interacting with the Planet Data API.
-    `orders`: Orders API.
-    `subscriptions`: Subscriptions API.
-    `features`: Features API
+
+    - `data`: for interacting with the Planet Data API.
+    - `orders`: Orders API.
+    - `subscriptions`: Subscriptions API.
+    - `features`: Features API
 
     Quick start example:
     ```python
@@ -35,13 +36,8 @@ class Planet:
 
     Parameters:
         session: Optional Session. The Session can be provided allowing for customization, and
-            will default to standard behavior when not provided. Example:
-
-          ```python
-          from planet.sync import Planet
+            will default to standard behavior when not provided.
 
-          pl = Planet()
-          ````
     """
 
     def __init__(self, session: Optional[Session] = None) -> None: