FIX: Address Copilot review - fix exception hierarchy, Linux archs, security notes

Author: dlevy-msft-sql

.github/copilot-instructions.md

@@ -30,6 +30,8 @@ This repository includes detailed prompt files for common tasks. Reference these
 
 ## Usage Examples (For Suggesting to Users)
 
+> **Security Note**: Examples use `TrustServerCertificate=yes` for local development with self-signed certificates. For production, remove this option to ensure proper TLS certificate validation.
+
 ### Basic Connection and Query
 ```python
 import mssql_python
@@ -259,14 +261,17 @@ The `ddbc_bindings.py` module implements sophisticated architecture detection:
 Critical for error handling guidance:
 
 ```
-Error (base)
-├── DatabaseError
-│   ├── InterfaceError      # Driver/interface issues
-│   ├── OperationalError    # Connection/timeout issues
-│   ├── IntegrityError      # Constraint violations
-│   ├── ProgrammingError    # SQL syntax errors
-│   └── DataError           # Invalid data processing
-└── Warning
+Exception (base)
+├── Warning
+└── Error
+    ├── InterfaceError          # Driver/interface issues
+    └── DatabaseError
+        ├── DataError            # Invalid data processing
+        ├── OperationalError     # Connection/timeout issues
+        ├── IntegrityError       # Constraint violations
+        ├── InternalError        # Internal driver/database errors
+        ├── ProgrammingError     # SQL syntax errors
+        └── NotSupportedError    # Unsupported features/operations
 ```
 
 ## Critical Anti-Patterns (DO NOT)

llms.txt

@@ -52,6 +52,8 @@ sudo ACCEPT_EULA=Y zypper install -y msodbcsql18
 
 ## Quick Start
 
+> **Security Note**: The examples below use `TrustServerCertificate=yes` for local development with self-signed certificates. For production or remote connections, remove this option to ensure proper TLS certificate validation.
+
 ```python
 import mssql_python
 
@@ -295,7 +297,7 @@ conn = mssql_python.connect("SERVER=...;DATABASE=...")
 
 - Windows (x64, ARM64)
 - macOS (ARM64, x86_64)
-- Linux: Debian, Ubuntu, RHEL, SUSE (x64), Alpine (musl)
+- Linux (x86_64, ARM64): Debian, Ubuntu, RHEL, SUSE, Alpine (musl)
 
 ## Supported Python Versions