better docs

Author: dot-agi

docs/mint.json

@@ -158,7 +158,7 @@
       "pages": [
         "v2/concepts/core-concepts",
         "v2/concepts/decorators",
-        "v2/concepts/sessions",
+        "v2/concepts/traces",
         "v2/concepts/spans",
         "v2/concepts/tags"
       ],

docs/v2/concepts/sessions.mdx

@@ -4,28 +4,32 @@ description: 'Organize and filter your sessions with customizable tags'
 ---
 ## Adding Tags
 
-You can add tags when initializing AgentOps, which is the most common approach:
+You can add tags when initializing AgentOps, whicreh is the most common approach:
 
 ```python
 import agentops
 
 # Initialize AgentOps with tags
 agentops.init(
     api_key="YOUR_API_KEY",
-    tags=["production", "customer-service", "gpt-4"]
+    default_tags=["production", "customer-service", "gpt-4"]
 )
 ```
 
-Alternatively, when using manual session creation:
+Alternatively, when using manual trace creation:
 
 ```python
 # Initialize without auto-starting a session
 agentops.init(api_key="YOUR_API_KEY", auto_start_session=False)
 
-# Later start a session with specific tags
-agentops.start_session(tags=["development", "testing", "claude-3"])
+# Later start a trace with specific tags (modern approach)
+trace = agentops.start_trace(trace_name="test_workflow", default_tags=["development", "testing", "claude-3"])
 ```
 
+<Note>
+Legacy approach using `agentops.start_session(default_tags=["development", "testing", "claude-3"])` is deprecated and will be removed in v4.0. Use `agentops.start_trace()` instead.
+</Note>
+
 ## Tag Use Cases
 
 Tags can be used for various purposes:
@@ -35,39 +39,39 @@ Tags can be used for various purposes:
 Tag sessions based on their environment:
 
 ```python
-tags=["production"] # or ["development", "staging", "testing"]
+default_tags=["production"] # or ["development", "staging", "testing"]
 ```
 
 ### Feature Tracking
 
 Tag sessions related to specific features or components:
 
 ```python
-tags=["search-functionality", "user-authentication", "content-generation"]
+default_tags=["search-functionality", "user-authentication", "content-generation"]
 ```
 
 ### User Segmentation
 
 Tag sessions based on user characteristics:
 
 ```python
-tags=["premium-user", "new-user", "enterprise-customer"]
+default_tags=["premium-user", "new-user", "enterprise-customer"]
 ```
 
 ### Experiment Tracking
 
 Tag sessions as part of specific experiments:
 
 ```python
-tags=["experiment-123", "control-group", "variant-A"]
+default_tags=["experiment-123", "control-group", "variant-A"]
 ```
 
 ### Model Identification
 
 Tag sessions with the models being used:
 
 ```python
-tags=["gpt-4", "claude-3-opus", "mistral-large"]
+default_tags=["gpt-4", "claude-3-opus", "mistral-large"]
 ```
 
 ## Viewing Tagged Sessions