Merge pull request #430 from ryanfowler/doc-updates

Fix missing formats and vague defaults in docs

Author: ryanfowler

docs/cli-reference.md

@@ -304,7 +304,7 @@ fetch --timeout 2.5 example.com
 
 ### `--redirects NUM`
 
-Maximum automatic redirects. Use `0` to disable.
+Maximum automatic redirects. Default: `10`. Use `0` to disable.
 
 ```sh
 fetch --redirects 0 example.com   # Don't follow redirects
@@ -563,20 +563,21 @@ fetch --from-curl 'https://example.com'
 
 **Supported curl flags:**
 
-| Category | Curl Flags |
-|---|---|
-| Request | `-X`, `-H`, `-d`, `--data-raw`, `--data-binary`, `--data-urlencode`, `--json`, `-F`, `-T`, `-I`, `-G` |
-| Auth | `-u`, `--aws-sigv4`, `--oauth2-bearer` |
-| TLS | `-k`, `--cacert`, `-E`/`--cert`, `--key`, `--tlsv1.x` |
-| Output | `-o`, `-O`, `-J` |
-| Network | `-L`, `--max-redirs`, `-m`/`--max-time`, `--connect-timeout`, `-x`, `--unix-socket`, `--doh-url`, `--retry`, `--retry-delay`, `-r` |
-| HTTP version | `-0`, `--http1.1`, `--http2`, `--http3` |
-| Headers | `-A`, `-e`, `-b` |
-| Verbosity | `-v`, `-s` |
-| Protocol | `--proto` (restricts allowed protocols; errors if URL scheme is not allowed) |
-| No-ops | `--compressed`, `-S`, `-N`, `--no-keepalive`, `-#`, `--no-progress-meter`, `-n`, `-f`, `--fail-with-body`, `--proto-default`, `--proto-redir` |
+| Category     | Curl Flags                                                                                                                                    |
+| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| Request      | `-X`, `-H`, `-d`, `--data-raw`, `--data-binary`, `--data-urlencode`, `--json`, `-F`, `-T`, `-I`, `-G`                                         |
+| Auth         | `-u`, `--aws-sigv4`, `--oauth2-bearer`                                                                                                        |
+| TLS          | `-k`, `--cacert`, `-E`/`--cert`, `--key`, `--tlsv1.x`                                                                                         |
+| Output       | `-o`, `-O`, `-J`                                                                                                                              |
+| Network      | `-L`, `--max-redirs`, `-m`/`--max-time`, `--connect-timeout`, `-x`, `--unix-socket`, `--doh-url`, `--retry`, `--retry-delay`, `-r`            |
+| HTTP version | `-0`, `--http1.1`, `--http2`, `--http3`                                                                                                       |
+| Headers      | `-A`, `-e`, `-b`                                                                                                                              |
+| Verbosity    | `-v`, `-s`                                                                                                                                    |
+| Protocol     | `--proto` (restricts allowed protocols; errors if URL scheme is not allowed)                                                                  |
+| No-ops       | `--compressed`, `-S`, `-N`, `--no-keepalive`, `-#`, `--no-progress-meter`, `-n`, `-f`, `--fail-with-body`, `--proto-default`, `--proto-redir` |
 
 **Notes:**
+
 - `-b`/`--cookie` only supports inline cookie strings (e.g., `-b 'name=value'`). Cookie jar files are not supported and will return an error.
 - `--data-urlencode` supports `@filename` and `name@filename` forms for reading and URL-encoding file contents.
 

docs/configuration.md

@@ -274,7 +274,7 @@ connect-timeout = 2.5
 #### `timeout`
 
 **Type**: Number (seconds)
-**Default**: System default
+**Default**: None (no timeout)
 
 Set a timeout for HTTP requests. Accepts decimal values.
 
@@ -289,7 +289,7 @@ timeout = 2.5
 #### `redirects`
 
 **Type**: Integer
-**Default**: System default
+**Default**: `10`
 
 Set the maximum number of automatic redirects to follow.
 
@@ -350,7 +350,7 @@ http = 2
 
 **Type**: String
 **Values**: `1.0`, `1.1`, `1.2`, `1.3`
-**Default**: System default
+**Default**: `1.2`
 
 Specify the minimum TLS version to use.
 

docs/getting-started.md

@@ -105,6 +105,8 @@ fetch httpbin.org/json | jq '.slideshow.title'
 - **XML / HTML** - Indented and highlighted
 - **CSS** - Formatted and highlighted
 - **CSV** - Column-aligned table output
+- **Markdown** - Rendered with terminal formatting
+- **YAML** - Syntax highlighted
 - **Images** - Rendered directly in supported terminals
 - **Protobuf / msgpack** - Decoded and displayed as JSON
 - **SSE / NDJSON** - Streamed line-by-line