tweak wording, update links

packages/kit/src/core/config/options.js

@@ -245,7 +245,7 @@ const options = object(
 					(/** @type {any} */ { message }) => {
 						throw new Error(
 							message +
-								'\nTo suppress or handle this error, implement `handleNotPrerenderedRoutes` in https://kit.svelte.dev/docs/configuration#prerender'
+								'\nTo suppress or handle this error, implement `handleNotPrerenderedRoutes` in https://svelte.dev/docs/kit/configuration#prerender'
 						);
 					},
 					(input, keypath) => {

packages/kit/src/core/postbuild/prerender.js

@@ -162,8 +162,8 @@ async function prerender({ hash, out, manifest_path, metadata, verbose, env }) {
 	const handle_not_prerendered_route = normalise_error_handler(
 		log,
 		config.prerender.handleNotPrerenderedRoutes,
-		({ notPrerenderedRoutes }) => {
-			const list = notPrerenderedRoutes.map((id) => `  - ${id}`).join('\n');
+		({ routes }) => {
+			const list = routes.map((id) => `  - ${id}`).join('\n');
 			return `The following routes were marked as prerenderable, but were not prerendered because they were not found while crawling your app:\n${list}\n\nSee https://svelte.dev/docs/kit/page-options#prerender-troubleshooting for info on how to solve this`;
 		}
 	);
@@ -535,7 +535,7 @@ async function prerender({ hash, out, manifest_path, metadata, verbose, env }) {
 	}
 
 	if (not_prerendered.length > 0) {
-		handle_not_prerendered_route({ notPrerenderedRoutes: not_prerendered });
+		handle_not_prerendered_route({ routes: not_prerendered });
 	}
 
 	return { prerendered, prerender_map };

packages/kit/src/exports/public.d.ts

@@ -649,7 +649,10 @@ export interface KitConfig {
 		 * - `'fail'` — fail the build
 		 * - `'ignore'` - silently ignore the failure and continue
 		 * - `'warn'` — continue, but print a warning
-		 * - `(details) => void` — a custom error handler that takes a `details` object with `notPrerenderedRoutes` property. If you `throw` from this function, the build will fail
+		 * - `(details) => void` — a custom error handler that takes a `details` object with a `routes` property which contains all routes that haven't been prerendered. If you `throw` from this function, the build will fail
+		 *
+		 * The default behavior is to fail the build. This may be undesireable when you know that some of your routes may never be reached under certain
+		 * circumstances such as a CMS not returning data for a specific area, resulting in the certain routes never being reached.
 		 *
 		 * @default "fail"
 		 * @since 2.5.0

packages/kit/src/types/private.d.ts

@@ -209,7 +209,7 @@ export interface PrerenderEntryGeneratorMismatchHandler {
 }
 
 export interface PrerenderEntryMissingRoutesHandler {
-	(details: { notPrerenderedRoutes: string[]; message: string }): void;
+	(details: { routes: string[]; message: string }): void;
 }
 
 export type PrerenderHttpErrorHandlerValue = 'fail' | 'warn' | 'ignore' | PrerenderHttpErrorHandler;

packages/kit/types/index.d.ts

@@ -630,7 +630,10 @@ declare module '@sveltejs/kit' {
 			 * - `'fail'` — fail the build
 			 * - `'ignore'` - silently ignore the failure and continue
 			 * - `'warn'` — continue, but print a warning
-			 * - `(details) => void` — a custom error handler that takes a `details` object with `notPrerenderedRoutes` property. If you `throw` from this function, the build will fail
+			 * - `(details) => void` — a custom error handler that takes a `details` object with a `routes` property which contains all routes that haven't been prerendered. If you `throw` from this function, the build will fail
+			 *
+			 * The default behavior is to fail the build. This may be undesireable when you know that some of your routes may never be reached under certain
+			 * circumstances such as a CMS not returning data for a specific area, resulting in the resulting routes never being reached.
 			 *
 			 * @default "fail"
 			 * @since 2.5.0