Refine return patterns and fix documentation example

Return Pattern Refinements:
- Keep explicit 'return None' only for early exits (good practice)
- Remove redundant explicit returns at end of functions (idiomatic Python)

Documentation Improvements:
- Fix _calculate_retry_delay example to use correct parameter names (backoff vs base_delay)
- Remove Mock dependency from example code for better user experience
- Provide self-contained, runnable examples that users can actually execute
- Examples now demonstrate exponential backoff behavior clearly

All 48 tests continue to pass with refined patterns.

Author: suyask-msft

src/PowerPlatform/Dataverse/client.py

@@ -481,7 +481,6 @@ def delete_table(self, tablename: str) -> None:
                 client.delete_table("SampleItem")
         """
         self._get_odata()._delete_table(tablename)
-        return None
 
     def list_tables(self) -> list[str]:
         """

src/PowerPlatform/Dataverse/core/http.py

@@ -153,17 +153,20 @@ def _calculate_retry_delay(self, attempt: int, response: Optional[requests.Respo
         Example:
             Calculate delays for successive retry attempts::
 
-                client = HttpClient(base_delay=1.0, max_backoff=30.0, jitter=True)
+                client = HttpClient(backoff=1.0, max_backoff=30.0, jitter=True)
                 
-                # Attempt 0: ~1.0s ± 25% jitter = 0.75s - 1.25s  
-                delay0 = client._calculate_retry_delay(0)
+                # Exponential backoff examples (without jitter for predictable values)
+                client_no_jitter = HttpClient(backoff=0.5, jitter=False)
                 
-                # Attempt 2: ~4.0s ± 25% jitter = 3.0s - 5.0s
-                delay2 = client._calculate_retry_delay(2)
+                # Attempt 0: 0.5s (0.5 * 2^0)
+                delay0 = client_no_jitter._calculate_retry_delay(0)
                 
-                # With Retry-After header (takes precedence)
-                response_with_retry_after = Mock(headers={"Retry-After": "15"})
-                delay = client._calculate_retry_delay(1, response_with_retry_after)  # Returns 15.0
+                # Attempt 2: 2.0s (0.5 * 2^2) 
+                delay2 = client_no_jitter._calculate_retry_delay(2)
+                
+                # With jitter enabled, delays vary randomly within ±25%
+                # Attempt 1 with jitter: ~1.0s ± 0.25s = 0.75s - 1.25s
+                delay_with_jitter = client._calculate_retry_delay(1)
         """
 
         # Check for Retry-After header (RFC 7231)

src/PowerPlatform/Dataverse/data/odata.py

@@ -388,7 +388,6 @@ def _update(self, logical_name: str, key: str, data: Dict[str, Any]) -> None:
         entity_set = self._entity_set_from_logical(logical_name)
         url = f"{self.api}/{entity_set}{self._format_key(key)}"
         r = self._request("patch", url, headers={"If-Match": "*"}, json=data)
-        return None
 
     def _update_multiple(self, entity_set: str, logical_name: str, records: List[Dict[str, Any]]) -> None:
         """Bulk update existing records via the collection-bound UpdateMultiple action.
@@ -446,7 +445,6 @@ def _delete(self, logical_name: str, key: str) -> None:
         entity_set = self._entity_set_from_logical(logical_name)
         url = f"{self.api}/{entity_set}{self._format_key(key)}"
         self._request("delete", url, headers={"If-Match": "*"})
-        return None
 
     def _get(self, logical_name: str, key: str, select: Optional[str] = None) -> Dict[str, Any]:
         """Retrieve a single record.
@@ -1171,7 +1169,6 @@ def _delete_table(self, tablename: str) -> None:
         metadata_id = ent["MetadataId"]
         url = f"{self.api}/EntityDefinitions({metadata_id})"
         r = self._request("delete", url)
-        return None
 
     def _create_table(
         self,

src/PowerPlatform/Dataverse/utils/pandas_adapter.py

@@ -86,7 +86,6 @@ def update(self, logical_name: str, record_id: str, entity_data: pd.Series) -> N
         if not payload:
             return None  # nothing to send
         self._c.update(logical_name, record_id, payload)
-        return None
 
     # ---------------------------- Delete ---------------------------------
     def delete_ids(self, logical_name: str, ids: Sequence[str] | pd.Series | pd.Index) -> pd.DataFrame: