chore: import upstream snapshot with attribution

scripts/release-docs.ts

@@ -0,0 +1,48 @@
+import { execSync } from 'child_process';
+import { gte, major, maxSatisfying } from 'semver';
+
+// The GITHUB_REF_NAME is a full version (i.e. 17.3.2). The branchName will strip the patch version number.
+// We will publish docs to the website branch based on the current tag (i.e. website-17)
+const dryRun = process.argv.includes('--dryRun');
+if (dryRun) {
+  console.log('Dry run mode enabled');
+}
+const currentVersion = process.env.GITHUB_REF_NAME || '';
+console.log(`Comparing ${currentVersion} to npm versions`);
+
+const majorVersion = major(currentVersion);
+let releasedVersions: string[] = JSON.parse(
+  execSync(`npm show nx@^${majorVersion} version --json`, {
+    windowsHide: false,
+  }).toString()
+);
+if (typeof releasedVersions === 'string') {
+  releasedVersions = [releasedVersions];
+}
+
+const latestVersion = maxSatisfying(releasedVersions, `^${majorVersion}`);
+
+console.log(`Found npm versions:\n${releasedVersions.join('\n')}`);
+
+// Publish if the current version is greater than or equal to the latest released version
+
+const branchName = `website-${majorVersion}`;
+if (
+  !dryRun &&
+  currentVersion &&
+  latestVersion &&
+  gte(currentVersion, latestVersion)
+) {
+  console.log(
+    `Publishing docs site for ${process.env.GITHUB_REF_NAME} to ${branchName}`
+  );
+  // We force recreate the branch in order to always be up to date and avoid merge conflicts within the automated workflow
+  execSync(`git branch -f ${branchName}`, {
+    windowsHide: false,
+  });
+  execSync(`git push -f origin ${branchName}`, {
+    windowsHide: false,
+  });
+} else {
+  console.log(`Not publishing docs to ${branchName}`);
+}