fix: correct README.md imports and URLs for PyPI display

Fixes errors visible on PyPI package page (https://pypi.org/project/honeyhive/1.0.0rc3/):

1. Import Path Error:
   - Fixed: from honeyhive.tracer.decorators import trace (WRONG)
   - To: from honeyhive import trace (CORRECT)

2. Documentation URL Error:
   - Fixed: https://docs.honeyhive.ai/... (non-existent domain)
   - To: https://honeyhiveai.github.io/python-sdk/... (actual docs)

3. Code Simplification:
   - Removed redundant backward compatibility comment
   - Cleaned up Quick Start example for clarity

The README.md file is the source for PyPI's project description page
(configured via pyproject.toml: readme = "README.md")

These fixes will appear on PyPI when the next version is published.

Author: josh-hhai

CHANGELOG.md

@@ -1,5 +1,12 @@
 ## [Unreleased]
 
+### Fixed
+- **📚 README: Corrected Import Path for PyPI Display**
+  - Fixed incorrect import `from honeyhive.tracer.decorators import trace` → `from honeyhive import trace`
+  - Fixed documentation URL from `docs.honeyhive.ai` to `honeyhiveai.github.io/python-sdk`
+  - Simplified Quick Start example (removed redundant comments)
+  - Ensures PyPI package page shows correct usage examples
+
 ### Changed
 - **Version 1.0.0-rc3**: Bumped from 0.1.0-rc3 to reflect stable API
 - **📚 Documentation: Strands Integration - Instance Method Pattern**

README.md

@@ -73,7 +73,7 @@ pip install honeyhive
 
 **📋 Including in Your Project**
 
-For detailed guidance on including HoneyHive in your `pyproject.toml`, see our [pyproject.toml Integration Guide](https://docs.honeyhive.ai/how-to/deployment/pyproject-integration.html).
+For detailed guidance on including HoneyHive in your `pyproject.toml`, see our [pyproject.toml Integration Guide](https://honeyhiveai.github.io/python-sdk/how-to/deployment/pyproject-integration.html).
 
 ### Development Installation
 
@@ -124,18 +124,15 @@ tox -e format && tox -e lint
 ### Basic Usage
 
 ```python
-from honeyhive import HoneyHiveTracer
-from honeyhive.tracer.decorators import trace
+from honeyhive import HoneyHiveTracer, trace
 
-# Initialize tracer using the recommended init method (simplified API)
+# Initialize tracer
 tracer = HoneyHiveTracer.init(
     api_key="your-api-key",
-    source="production"  # project derived from API key automatically
+    project="your-project",
+    source="production"
 )
 
-# Backward compatibility: project parameter still accepted but optional
-# tracer = HoneyHiveTracer.init(api_key="your-api-key", project="your-project", source="production")
-
 # Use unified decorator for automatic tracing (works with both sync and async)
 @trace(event_type="demo", event_name="my_function")
 def my_function():