docs: add changesets

Author: mrlubos

.changeset/fix-runtime-config-path.md

@@ -3,3 +3,8 @@
 ---
 
 **BREAKING** **client**: resolve `runtimeConfigPath` relative to the output folder
+
+### Changed `runtimeConfigPath` behavior
+
+This was a known, long-standing issue confusing first-time users. Before, defining client `runtimeConfigPath` value would paste it verbatim to the generated output. This release changes the behavior to resolve relative to the output folder.
+

.changeset/weak-avocados-tap.md

@@ -2,4 +2,8 @@
 "@hey-api/openapi-ts": minor
 ---
 
-**plugin(@hey-api/client-ky)**: respect ky instance defaults
+**BREAKING** **plugin(@hey-api/client-ky)**: respect ky instance defaults
+
+### Changed Ky client behavior
+
+The Ky client was updated to be more intuitive. Some Ky options now need to be passed via the `kyOptions` field and you need to pass `undefined` to unset an option.

docs/openapi-ts/migrating.md

@@ -7,6 +7,16 @@ description: Migrating to @hey-api/openapi-ts.
 
 While we try to avoid breaking changes, sometimes it's unavoidable in order to offer you the latest features. This page lists changes that require updates to your code. If you run into a problem with migration, please [open an issue](https://github.com/hey-api/openapi-ts/issues).
 
+## v0.97.0
+
+### Changed `runtimeConfigPath` behavior
+
+This was a known, long-standing issue confusing first-time users. Before, defining client `runtimeConfigPath` value would paste it verbatim to the generated output. This release changes the behavior to resolve relative to the output folder.
+
+### Changed Ky client behavior
+
+The Ky client was updated to be more intuitive. Some Ky options now need to be passed via the `kyOptions` field and you need to pass `undefined` to unset an option.
+
 ## v0.96.0
 
 ### Removed Node 20 support

packages/openapi-ts/src/plugins/@hey-api/client-core/client.ts

@@ -15,16 +15,15 @@ export function resolveRuntimeConfigPath({
   outputPath: string;
   runtimeConfigPath: string;
 }): string {
-  const isFileSystemPath =
-    path.isAbsolute(runtimeConfigPath) ||
-    runtimeConfigPath.startsWith('./') ||
-    runtimeConfigPath.startsWith('../');
+  const isAbsolutePath = path.isAbsolute(runtimeConfigPath);
 
+  const isFileSystemPath =
+    isAbsolutePath || runtimeConfigPath.startsWith('./') || runtimeConfigPath.startsWith('../');
   if (!isFileSystemPath) {
     return runtimeConfigPath;
   }
 
-  const absoluteInputPath = path.isAbsolute(runtimeConfigPath)
+  const absoluteInputPath = isAbsolutePath
     ? runtimeConfigPath
     : path.resolve(process.cwd(), runtimeConfigPath);
   const relative = path.relative(outputPath, absoluteInputPath).split(path.sep).join('/');