docs: updated comments

Author: wyattjoh

packages/next/src/build/static-paths/app.test.ts

@@ -7,7 +7,7 @@ import {
 import type { PrerenderedRoute } from './types'
 
 describe('assignErrorIfEmpty', () => {
-  it('should assign throwOnEmptyStaticShell false for a static route', () => {
+  it('should assign throwOnEmptyStaticShell true for a static route with no children', () => {
     const prerenderedRoutes: PrerenderedRoute[] = [
       {
         params: {},
@@ -25,7 +25,7 @@ describe('assignErrorIfEmpty', () => {
     expect(prerenderedRoutes[0].throwOnEmptyStaticShell).toBe(true)
   })
 
-  it('should assign throwOnEmptyStaticShell to the prerendered routes', () => {
+  it('should assign throwOnEmptyStaticShell based on route hierarchy', () => {
     const prerenderedRoutes: PrerenderedRoute[] = [
       {
         params: {},

packages/next/src/build/static-paths/app.ts

@@ -623,7 +623,7 @@ export async function buildAppStaticPaths({
   if (hadAllParamsGenerated || isRoutePPREnabled) {
     if (isRoutePPREnabled) {
       // Discover all unique combinations of the rootParams so we can generate
-      // shells for each of them if they're available.
+      // routes that won't throw on empty static shell for each of them if they're available.
       routeParams.unshift(
         ...filterUniqueRootParamsCombinations(rootParamKeys, routeParams)
       )