Update examples, update validator recommendation

[drwpow]

Changes

Updates examples.

Removes swagger-cli as a subtle suggestion in favor of the much better Redocly CLI.

Also makes a few other minor docs improvements.

[changeset-bot]

⚠️ No Changeset found

Latest commit: caf4a1d

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Pages

Latest commit:	caf4a1d
Status:	✅  Deploy successful!
Preview URL:	https://331d7daf.openapi-ts.pages.dev
Branch Preview URL:	https://update-docs.openapi-ts.pages.dev

View logs

[drwpow]

🤔 Wondering if there’s a better way to say this. Only lately realized that there is an entire school of thought that believes codegen is a natural pair to OpenAPI and I strongly disagree. After all, why impose heavy runtime SDKs on things that don’t need it? TypeScript has the superpower of static inference that can deliver all the resiliency of static typing but without any runtime impact. In a sense, codegen feels antithetical to how TypeScript works itself.

Anyway, there are probably better terms to express this sentiment, but just putting this placeholder idea here for now.