From 8f5d3dccc94f21b7814c8e389e692d0bc03d542c Mon Sep 17 00:00:00 2001
From: Craigory Coppola <craigorycoppola@gmail.com>
Date: Thu, 25 Jul 2024 16:52:40 -0400
Subject: [PATCH] chore(repo): cache documentation script (#27100)

<!-- Please make sure you have read the submission guidelines before
posting an PR -->
<!--
https://github.com/nrwl/nx/blob/master/CONTRIBUTING.md#-submitting-a-pr
-->

<!-- Please make sure that your commit message follows our format -->
<!-- Example: `fix(nx): must begin with lowercase` -->

<!-- If this is a particularly complex change or feature addition, you
can request a dedicated Nx release for this pull request branch. Mention
someone from the Nx team or the `@nrwl/nx-pipelines-reviewers` and they
will confirm if the PR warrants its own release for testing purposes,
and generate it for you if appropriate. -->

## Current Behavior
`documentation` is not cacheable. It is reran everytime someone tries to
push, including the following flow:

- git push, fails as docs changes found
- git commit -am "chore(repo): add docs"
- git push, runs full docs cycle again in pre-push hook

## Expected Behavior
`documentation` is cacheable, and avoids rerunning when no fs changes
are made

## Related Issue(s)
<!-- Please link the issue being fixed so it gets closed when this is
merged. -->

Fixes #
---
 package.json | 21 ++++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 6366d2b491..e96dde9972 100644
--- a/package.json
+++ b/package.json
@@ -376,7 +376,26 @@
       "check-lock-files",
       "check-codeowners",
       "documentation"
-    ]
+    ],
+    "targets": {
+      "documentation": {
+        "cache": true,
+        "inputs": [
+          "{workspaceRoot}/packages/**", 
+          "{workspaceRoot}/docs/**",
+          "{workspaceRoot}/scripts/documentation/**",
+          "!{workspaceRoot}/docs/generated", 
+          "!{workspaceRoot}/packages/**/*.spec.ts",
+          "!{workspaceRoot}/packages/**/project.json",
+          "!{workspaceRoot}/packages/**/tsconfig.json",
+          "!{workspaceRoot}/packages/**/tsconfig.lib.json",
+          "!{workspaceRoot}/packages/**/tsconfig.spec.json",
+          "!{workspaceRoot}/packages/**/jest.config.{ts,js}",
+          "!{workspaceRoot}/packages/**/.eslintrc.json"
+        ]
+      },
+      "outputs": ["{workspaceRoot}/docs/generated"]
+    }
   },
   "packageManager": "pnpm@8.15.7"
 }