From c69e99f6f4ad7ceea1ee47291a5317ed7a85273d Mon Sep 17 00:00:00 2001
From: Benjamin Cabanes <3447705+bcabanes@users.noreply.github.com>
Date: Thu, 22 Dec 2022 13:18:58 -0500
Subject: [PATCH] docs(nxdev): take into account custom description (#13987)

---
 nx-dev/models-package/src/lib/package.models.ts          | 9 +++++----
 .../package-schemas/generatePackageSchemas.ts            | 2 +-
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/nx-dev/models-package/src/lib/package.models.ts b/nx-dev/models-package/src/lib/package.models.ts
index a9bcc2f5e5671..4e6950df3b222 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 72bd575fff43e..3e8dd52f24664 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,