added some comment

Author: conico974

packages/open-next/src/build/patch/patches/patchEnvVar.ts

@@ -2,7 +2,7 @@ import { createPatchCode } from "../astCodePatcher.js";
 import type { CodePatcher } from "../codePatcher";
 
 /**
- * This function create an ast-grep rule to replace specific env var inside an if.
+ * Creates a rule to replace `process.env.${envVar}` by `value` in the condition of if statements
  * This is used to avoid loading unnecessary deps at runtime
  * @param envVar The env var that we want to replace
  * @param value The value that we want to replace it with

packages/open-next/src/types/open-next.ts

@@ -120,10 +120,11 @@ export interface ResolvedRoute {
 
 /**
  * The route preloading behavior. Only supported in Next 15+.
- * - "none" - No preloading of the route at all
- * - "withWaitUntil" - Preload the route using the waitUntil provided by the wrapper - If not supported, it will fallback to "none"
+ * Default behavior of Next is disabled. You should do your own testing to choose which one suits you best
+ * - "none" - No preloading of the route at all. This is the default
+ * - "withWaitUntil" - Preload the route using the waitUntil provided by the wrapper - If not supported, it will fallback to "none". At the moment only cloudflare wrappers provide a `waitUntil`
  * - "onWarmerEvent" - Preload the route on the warmer event - Needs to be implemented by the wrapper. Only supported in `aws-lambda-streaming` wrapper for now
- * - "onStart" - Preload the route before even invoking the wrapper - This is a blocking operation. The handler will only be created after all the routes have been loaded, it may increase the cold start time by a lot in some cases.
+ * - "onStart" - Preload the route before even invoking the wrapper - This is a blocking operation. The handler will only be created after all the routes have been loaded, it may increase the cold start time by a lot in some cases. Useful for long running server or in serverless with some careful testing
  * @default "none"
  */
 export type RoutePreloadingBehavior =