docs: Update README and CHANGELOG for Request field renaming

- Added documentation for new Request field names in README
- Added clear mapping between Request fields and :httpc.request arguments
- Updated CHANGELOG with detailed field renaming information
- Enhanced field naming explanation with technical details

Documents the improved field naming convention:
- : 3rd argument to :httpc.request (request-specific HTTP options)
- : 4th argument to :httpc.request (client-specific options)

Author: GSMLG-BOT

CHANGELOG.md

@@ -11,19 +11,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **URI struct support** - HTTP.fetch/2 now accepts both string URLs and %URI{} structs
 - **Enhanced URL handling** - Automatic conversion from string to %URI{} for internal processing
 - **Type safety improvements** - HTTP.Request and HTTP.Response now use %URI{} internally
+- **Improved Request field naming** - More intuitive field names for :httpc.request mapping
 
 ### Changed
 - **Refactored URL handling** - All internal representations now use %URI{} instead of string
 - **Updated type specifications** - HTTP.Request.url type changed from String.t() | charlist() to URI.t()
 - **Updated Response.url type** - Changed from String.t() to URI.t()
 - **Updated function signatures** - handle_httpc_response and related functions now accept URI.t()
+- **HTTP.Request field renaming** for better clarity:
+  - `options` → `http_options` (3rd argument to :httpc.request)
+  - `opts` → `options` (4th argument to :httpc.request)
 
 ### Technical Details
 - **Backward compatibility** - String URLs are automatically parsed to URI structs
 - **Consistent URI handling** - All internal operations use parsed URI structs
 - **Eliminated redundant parsing** - Removed duplicate URI.parse calls in streaming functions
 - **Enhanced type safety** - Stronger typing throughout the codebase
 - **Updated test suite** - Request tests updated to use URI.parse/1 for consistency
+- **Improved field documentation** - Clear mapping to :httpc.request arguments
 
 ## [0.4.0] - 2025-07-30
 

README.md

@@ -106,10 +106,16 @@ request = %HTTP.Request{
   method: :post,
   url: URI.parse("https://api.example.com/data"),
   headers: [{"Authorization", "Bearer token"}],
-  body: "data"
+  body: "data",
+  http_options: [timeout: 10_000, connect_timeout: 5_000],
+  options: [sync: false, body_format: :binary]
 }
 ```
 
+**Field Mapping to :httpc.request/4:**
+- `http_options`: 3rd argument (request-specific HTTP options)
+- `options`: 4th argument (client-specific options)
+
 ### HTTP.FormData
 Handle form data and file uploads.