diff --git a/nx-dev/models-package/src/lib/package.models.ts b/nx-dev/models-package/src/lib/package.models.ts
index a9bcc2f5e5..4e6950df3b 100644
--- a/nx-dev/models-package/src/lib/package.models.ts
+++ b/nx-dev/models-package/src/lib/package.models.ts
@@ -24,13 +24,14 @@ export interface FileMetadata {
 export interface PackageData {
   description: string;
   documents: {
-    tags: string[];
-    id: string;
-    name: string;
-    itemList: any[];
     content: string;
+    description: string;
     file: string;
+    id: string;
+    itemList: any[];
+    name: string;
     path: string;
+    tags: string[];
   }[];
   executors: SchemaMetadata[];
   generators: SchemaMetadata[];
diff --git a/scripts/documentation/package-schemas/generatePackageSchemas.ts b/scripts/documentation/package-schemas/generatePackageSchemas.ts
index 72bd575fff..3e8dd52f24 100644
--- a/scripts/documentation/package-schemas/generatePackageSchemas.ts
+++ b/scripts/documentation/package-schemas/generatePackageSchemas.ts
@@ -66,7 +66,7 @@ export function generatePackageSchemas(): Promise<void[]> {
       description: p.description,
       documents: p.documents.map((d) => ({
         ...createDocumentMetadata({
-          description: p.description,
+          description: d.description || p.description,
           file: ['generated', 'packages', p.name, 'documents', d.id].join('/'),
           id: d.id,
           itemList: d.itemList,