docs(openapi): unify regex wording and shorten sourcePreference descriptions (#2051)

Stainless-Generated-From: dd255ae9cb6e681fc7ebaadde53848bc2d9ea4e9

Author: stlc-bot

go.mod

@@ -7,7 +7,7 @@ require (
 	github.com/charmbracelet/bubbletea v1.3.6
 	github.com/charmbracelet/lipgloss v1.1.0
 	github.com/charmbracelet/x/term v0.2.1
-	github.com/context-dot-dev/context-go-sdk/v2 v2.32.0
+	github.com/context-dot-dev/context-go-sdk/v2 v2.33.0
 	github.com/goccy/go-yaml v1.18.0
 	github.com/itchyny/json2yaml v0.1.4
 	github.com/muesli/reflow v0.3.0

go.sum

@@ -18,8 +18,8 @@ github.com/charmbracelet/x/exp/golden v0.0.0-20241011142426-46044092ad91 h1:payR
 github.com/charmbracelet/x/exp/golden v0.0.0-20241011142426-46044092ad91/go.mod h1:wDlXFlCrmJ8J+swcL/MnGUuYnqgQdW9rhSD61oNMb6U=
 github.com/charmbracelet/x/term v0.2.1 h1:AQeHeLZ1OqSXhrAWpYUtZyX1T3zVxfpZuEQMIQaGIAQ=
 github.com/charmbracelet/x/term v0.2.1/go.mod h1:oQ4enTYFV7QN4m0i9mzHrViD7TQKvNEEkHUMCmsxdUg=
-github.com/context-dot-dev/context-go-sdk/v2 v2.32.0 h1:rF7kVjfdI4QsHyRuZySwllnUpdrlWqMgvk6bdR1vk0k=
-github.com/context-dot-dev/context-go-sdk/v2 v2.32.0/go.mod h1:CvRANWLP0FHj5XyUwzEVX79ujdwr/2Jy375UVzKNQm8=
+github.com/context-dot-dev/context-go-sdk/v2 v2.33.0 h1:0Fz+wHuApoHkIVEqdRV1HRx1R1783JjG2w3h/UFL/6g=
+github.com/context-dot-dev/context-go-sdk/v2 v2.33.0/go.mod h1:CvRANWLP0FHj5XyUwzEVX79ujdwr/2Jy375UVzKNQm8=
 github.com/cpuguy83/go-md2man/v2 v2.0.2 h1:p1EgwI/C7NhT0JmVkwCD2ZBK8j4aeHQX2pMHHBfMQ6w=
 github.com/cpuguy83/go-md2man/v2 v2.0.2/go.mod h1:tgQtvFlXSQOSOSIRvRPT7W67SCa46tRHOmNcaadrF8o=
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=

pkg/cmd/web.go

@@ -485,7 +485,7 @@ var webWebCrawlMd = requestflag.WithInnerFlags(cli.Command{
 		},
 		&requestflag.Flag[string]{
 			Name:     "exclude-url-regex",
-			Usage:    "RE2 regex pattern. URLs matching this pattern are never followed or scraped, even when they match urlRegex. The starting URL is always scraped.",
+			Usage:    "Regex pattern. URLs matching this pattern are never followed or scraped, even when they match urlRegex. The starting URL is always scraped.",
 			BodyPath: "excludeUrlRegex",
 		},
 		&requestflag.Flag[bool]{
@@ -502,13 +502,13 @@ var webWebCrawlMd = requestflag.WithInnerFlags(cli.Command{
 		},
 		&requestflag.Flag[bool]{
 			Name:     "include-images",
-			Usage:    "Include image references in the Markdown output Only applies to `html-conversion` extractions.",
+			Usage:    "Include image references in the Markdown output (`html-conversion` only).",
 			Default:  false,
 			BodyPath: "includeImages",
 		},
 		&requestflag.Flag[bool]{
 			Name:     "include-links",
-			Usage:    "Preserve hyperlinks in the Markdown output Only applies to `html-conversion` extractions.",
+			Usage:    "Preserve hyperlinks in the Markdown output (`html-conversion` only).",
 			Default:  true,
 			BodyPath: "includeLinks",
 		},
@@ -548,13 +548,13 @@ var webWebCrawlMd = requestflag.WithInnerFlags(cli.Command{
 		},
 		&requestflag.Flag[bool]{
 			Name:     "shorten-base64-images",
-			Usage:    "Truncate base64-encoded image data in the Markdown output Only applies to `html-conversion` extractions.",
+			Usage:    "Truncate base64-encoded image data in the Markdown output (`html-conversion` only).",
 			Default:  true,
 			BodyPath: "shortenBase64Images",
 		},
 		&requestflag.Flag[[]string]{
 			Name:     "source-preference",
-			Usage:    "Where the Markdown should come from, in order of preference; the first usable source wins. `html-conversion` converts the page HTML, and counts as unusable when the conversion has almost no content (under 200 characters). `markdown-direct` uses the official Markdown version the page publishes through, returned as the site serves it. Defaults to `[\"html-conversion\", \"markdown-direct\"]`. With only `markdown-direct`, a page that publishes no Markdown fails with `NO_PUBLISHED_MARKDOWN` and is not billed. Requests with include or exclude selectors never use `markdown-direct`, so they must include `html-conversion`.",
+			Usage:    "Markdown sources in order of preference: `html-conversion` converts the page HTML, `markdown-direct` uses Markdown the site publishes.",
 			Default:  []string{"html-conversion", "markdown-direct"},
 			BodyPath: "sourcePreference",
 		},