Add Cookbook C01-C19 (draft)

docs-src/pages/en/cookbook/index.md

@@ -4,93 +4,93 @@ order: 0
 status: "draft"
 ---
 
-A collection of recipes that answer "How do I...?" questions. Each recipe is self-contained — read only what you need.
+A collection of recipes that answer "How do I...?" questions. Each recipe is self-contained — read only what you need. For an introduction to the basics, see the [Tour](../tour/).
 
 ## Client
 
 ### Basics
-- Get the response body as a string / save to a file
-- Send and receive JSON
-- Set default headers (`set_default_headers`)
-- Follow redirects (`set_follow_location`)
+- [C01. Get the response body / save to a file](c01-get-response-body)
+- [C02. Send and receive JSON](c02-json)
+- [C03. Set default headers](c03-default-headers)
+- [C04. Follow redirects](c04-follow-location)
 
 ### Authentication
-- Use Basic authentication (`set_basic_auth`)
-- Call an API with a Bearer token
+- [C05. Use Basic authentication](c05-basic-auth)
+- [C06. Call an API with a Bearer token](c06-bearer-token)
 
 ### File Upload
-- Upload a file as multipart form data (`make_file_provider`)
-- POST a file as raw binary (`make_file_body`)
-- Send the body with chunked transfer (Content Provider)
+- [C07. Upload a file as multipart form data](c07-multipart-upload)
+- [C08. POST a file as raw binary](c08-post-file-body)
+- [C09. Send the body with chunked transfer](c09-chunked-upload)
 
 ### Streaming & Progress
-- Receive a response as a stream
-- Use the progress callback (`DownloadProgress` / `UploadProgress`)
+- [C10. Receive a response as a stream](c10-stream-response)
+- [C11. Use the progress callback](c11-progress-callback)
 
 ### Connection & Performance
-- Set timeouts (`set_connection_timeout` / `set_read_timeout`)
-- Set an overall timeout (`set_max_timeout`)
-- Understand connection reuse and Keep-Alive behavior
-- Enable compression (`set_compress` / `set_decompress`)
-- Send requests through a proxy (`set_proxy`)
+- [C12. Set timeouts](c12-timeouts)
+- [C13. Set an overall timeout](c13-max-timeout)
+- [C14. Understand connection reuse and Keep-Alive behavior](c14-keep-alive)
+- [C15. Enable compression](c15-compression)
+- [C16. Send requests through a proxy](c16-proxy)
 
 ### Error Handling & Debugging
-- Handle error codes (`Result::error()`)
-- Handle SSL errors (`ssl_error()` / `ssl_backend_error()`)
-- Set up client logging (`set_logger` / `set_error_logger`)
+- [C17. Handle error codes](c17-error-codes)
+- [C18. Handle SSL errors](c18-ssl-errors)
+- [C19. Set up client logging](c19-client-logger)
 
 ## Server
 
 ### Basics
-- Register GET / POST / PUT / DELETE handlers
-- Receive JSON requests and return JSON responses
-- Use path parameters (`/users/:id`)
-- Set up a static file server (`set_mount_point`)
+- S01. Register GET / POST / PUT / DELETE handlers
+- S02. Receive JSON requests and return JSON responses
+- S03. Use path parameters (`/users/:id`)
+- S04. Set up a static file server (`set_mount_point`)
 
 ### Streaming & Files
-- Stream a large file in the response (`ContentProvider`)
-- Return a file download response (`Content-Disposition`)
-- Receive multipart data as a stream (`ContentReader`)
-- Compress responses (gzip)
+- S05. Stream a large file in the response (`ContentProvider`)
+- S06. Return a file download response (`Content-Disposition`)
+- S07. Receive multipart data as a stream (`ContentReader`)
+- S08. Compress responses (gzip)
 
 ### Handler Chain
-- Add pre-processing to all routes (Pre-routing handler)
-- Add response headers with a Post-routing handler (CORS, etc.)
-- Authenticate per route with a Pre-request handler (`matched_route`)
-- Pass data between handlers with `res.user_data`
+- S09. Add pre-processing to all routes (Pre-routing handler)
+- S10. Add response headers with a Post-routing handler (CORS, etc.)
+- S11. Authenticate per route with a Pre-request handler (`matched_route`)
+- S12. Pass data between handlers with `res.user_data`
 
 ### Error Handling & Debugging
-- Return custom error pages (`set_error_handler`)
-- Catch exceptions (`set_exception_handler`)
-- Log requests (Logger)
-- Detect client disconnection (`req.is_connection_closed()`)
+- S13. Return custom error pages (`set_error_handler`)
+- S14. Catch exceptions (`set_exception_handler`)
+- S15. Log requests (Logger)
+- S16. Detect client disconnection (`req.is_connection_closed()`)
 
 ### Operations & Tuning
-- Assign a port dynamically (`bind_to_any_port`)
-- Control startup order with `listen_after_bind`
-- Shut down gracefully (`stop()` and signal handling)
-- Tune Keep-Alive (`set_keep_alive_max_count` / `set_keep_alive_timeout`)
-- Configure the thread pool (`new_task_queue`)
+- S17. Assign a port dynamically (`bind_to_any_port`)
+- S18. Control startup order with `listen_after_bind`
+- S19. Shut down gracefully (`stop()` and signal handling)
+- S20. Tune Keep-Alive (`set_keep_alive_max_count` / `set_keep_alive_timeout`)
+- S21. Configure the thread pool (`new_task_queue`)
+- S22. Communicate over Unix domain sockets (`set_address_family(AF_UNIX)`)
 
 ## TLS / Security
 
-- Choosing between OpenSSL, mbedTLS, and wolfSSL (build-time `#define` differences)
-- Control SSL certificate verification (disable, custom CA, custom callback)
-- Use a custom certificate verification callback (`set_server_certificate_verifier`)
-- Set up an SSL/TLS server (certificate and private key)
-- Configure mTLS (mutual TLS with client certificates)
-- Access the peer certificate on the server (`req.peer_cert()` / SNI)
+- T01. Choosing between OpenSSL, mbedTLS, and wolfSSL (build-time `#define` differences)
+- T02. Control SSL certificate verification (disable, custom CA, custom callback)
+- T03. Set up an SSL/TLS server (certificate and private key)
+- T04. Configure mTLS (mutual TLS with client certificates)
+- T05. Access the peer certificate on the server (`req.peer_cert()` / SNI)
 
 ## SSE
 
-- Implement an SSE server
-- Use event names to distinguish event types
-- Handle reconnection (`Last-Event-ID`)
-- Receive SSE events on the client
+- E01. Implement an SSE server
+- E02. Use event names to distinguish event types
+- E03. Handle reconnection (`Last-Event-ID`)
+- E04. Receive SSE events on the client
 
 ## WebSocket
 
-- Implement a WebSocket echo server and client
-- Configure heartbeats (`set_websocket_ping_interval` / `CPPHTTPLIB_WEBSOCKET_PING_INTERVAL_SECOND`)
-- Handle connection close
-- Send and receive binary frames
+- W01. Implement a WebSocket echo server and client
+- W02. Configure heartbeats (`set_websocket_ping_interval`)
+- W03. Handle connection close
+- W04. Send and receive binary frames