docs: improve taxonomy method visibility and quick references (#80)

resolves: trufnetwork/truf-network#1126

Author: MicBun

README.md

@@ -218,6 +218,13 @@ client.set_taxonomy(
  },
  start_date=current_timestamp
 )
+
+# Get taxonomy information for the composed stream
+taxonomy = client.describe_taxonomy(tech_innovation_index)
+if taxonomy:
+ print(f"Stream: {taxonomy['stream_id']}")
+ for child in taxonomy['child_streams']:
+ print(f" Child: {child.stream['stream_id']}, Weight: {child.weight}")
 ```
 
 ### Stream Visibility and Access Control
@@ -251,6 +258,26 @@ client.destroy_stream(stream_id)
 
 For a comprehensive example demonstrating the full stream lifecycle, refer to our [Complex Example](./examples/complex_example/README.md).
 
+## Quick Reference
+
+### Common Operations
+
+| Operation | Method |
+|-----------|--------|
+| Deploy primitive stream | `client.deploy_stream(stream_id, STREAM_TYPE_PRIMITIVE)` |
+| Deploy composed stream | `client.deploy_stream(stream_id, STREAM_TYPE_COMPOSED)` |
+| Insert records | `client.insert_record(stream_id, {"date": timestamp, "value": value})` |
+| Get stream data | `client.get_records(stream_id, date_from=from_ts, date_to=to_ts)` |
+| Set stream taxonomy | `client.set_taxonomy(stream_id, {child_id: weight}, start_date)` |
+| Get stream taxonomy | `client.describe_taxonomy(stream_id, latest_version=True)` |
+| Destroy stream | `client.destroy_stream(stream_id)` |
+
+### Key Constants
+
+- `STREAM_TYPE_PRIMITIVE` - Raw data streams
+- `STREAM_TYPE_COMPOSED` - Aggregated streams with taxonomy
+- `TaxonomyDetails` - Taxonomy information with child streams and weights
+
 ## Local Node Testing and Development
 
 This section describes how to set up a local development environment, including running a local node for testing and running the SDK's test suite.

docs/api-reference.md

@@ -401,8 +401,8 @@ tx_hash = client.set_taxonomy(
 )
 ```
 
-### `client.describe_taxonomy(stream_id: str, latest_version: bool = True) -> TaxonomyDetails | None`
-Get taxonomy structure of a composed stream.
+### `client.describe_taxonomy(stream_id: str, latest_version: bool = True) -> TaxonomyDetails | None` 🔍
+Get taxonomy structure of a composed stream. This is the primary method for discovering how composed streams aggregate their child streams and understanding composition relationships.
 
 #### Parameters
 - `stream_id: str` - Composed stream identifier
@@ -416,11 +416,24 @@ Get taxonomy structure of a composed stream.
 
 #### Example
 ```python
+# Get taxonomy information for a composed stream
 taxonomy = client.describe_taxonomy(composed_stream_id)
 if taxonomy:
  print(f"Stream: {taxonomy['stream_id']}")
+ total_weight = 0
  for child in taxonomy['child_streams']:
  print(f" Child: {child.stream['stream_id']}, Weight: {child.weight}")
+ total_weight += child.weight
+ print(f"Total weight: {total_weight}")
+else:
+ print("No taxonomy found for this stream")
+
+# Example: Validate taxonomy weights sum to 1.0
+if taxonomy:
+ weights = [child.weight for child in taxonomy['child_streams']]
+ total_weight = sum(weights)
+ if abs(total_weight - 1.0) > 0.001: # Allow small floating point differences
+ print(f"Warning: Weights don't sum to 1.0 (actual: {total_weight})")
 ```
 
 ### `client.allow_compose_stream(stream_id: str, wait: bool = True) -> str`