Add version v28 (#564)

<!-- cloudflare-preview --> Preview: https://pr-564.docs-gitea-com.pages.dev

Reviewed-on: https://gitea.com/gitea/docs/pulls/564
Reviewed-by: bircni <[email protected]>
Co-authored-by: Lunny Xiao <[email protected]>

packages/content-loader/src/index.ts

@@ -211,7 +211,12 @@ async function parseFile(
     tableOfContents: frontmatter.toc !== false,
     sidebarLabel: asString(frontmatter.sidebar_label),
     body,
-    digest: generateDigest(`${transformVersion}\u0000${substituted}`),
+    // the version and the route are part of the stored data, so they have to
+    // invalidate the entry too: an identical page of another version, or of the
+    // same version moved to another prefix, must not reuse a stale entry
+    digest: generateDigest(
+      `${transformVersion}\u0000${segment.product.id}/${segment.version.id}/${segment.locale}/${segment.prefix}\u0000${substituted}`,
+    ),
   };
 }
 
@@ -374,7 +379,9 @@ async function resolveCategories(
 
 async function renderCategory(context: LoaderContext, category: ParsedCategory): Promise<void> {
   const { generateDigest, parseData, renderMarkdown, store } = context;
-  const digest = generateDigest(`${transformVersion}\u0000${category.title}\u0000${category.body}`);
+  const digest = generateDigest(
+    `${transformVersion}\u0000${category.segment.product.id}/${category.segment.version.id}/${category.segment.locale}/${category.segment.prefix}\u0000${category.title}\u0000${category.body}`,
+  );
   if (store.get(category.id)?.digest === digest) return;
 
   const filePath = `${collectionRoot}/${category.id}.md`;