From 126a19ff0b7d7e19c41663513ddb02fbbb123094 Mon Sep 17 00:00:00 2001
From: Isaac Mann <isaacplmann@users.noreply.github.com>
Date: Wed, 28 Jun 2023 21:05:19 -0400
Subject: [PATCH] docs(core): finish changelog (#17840)

---
 docs/changelog/14_5_0.md                      |  9 +++++
 docs/changelog/15_0_0.md                      | 12 ++++++
 docs/changelog/15_3_0.md                      | 17 +++++++++
 docs/changelog/15_4_0.md                      | 13 +++++++
 docs/changelog/15_7_0.md                      | 16 ++++++++
 docs/changelog/15_8_0.md                      | 16 ++++++++
 docs/changelog/16_0_0.md                      |  4 +-
 docs/changelog/16_4_0.md                      |  7 ++++
 docs/generated/manifests/menus.json           | 16 ++++++++
 docs/generated/manifests/nx.json              | 20 ++++++++++
 docs/map.json                                 |  7 ++++
 nx-dev/nx-dev/pages/[...segments].tsx         |  7 +++-
 .../pages/{ => reference}/changelog.tsx       | 37 ++++++++++++++++---
 13 files changed, 173 insertions(+), 8 deletions(-)
 create mode 100644 docs/changelog/14_5_0.md
 create mode 100644 docs/changelog/15_3_0.md
 create mode 100644 docs/changelog/15_4_0.md
 create mode 100644 docs/changelog/15_7_0.md
 create mode 100644 docs/changelog/15_8_0.md
 create mode 100644 docs/changelog/16_4_0.md
 rename nx-dev/nx-dev/pages/{ => reference}/changelog.tsx (89%)

diff --git a/docs/changelog/14_5_0.md b/docs/changelog/14_5_0.md
new file mode 100644
index 0000000000..da97630f9e
--- /dev/null
+++ b/docs/changelog/14_5_0.md
@@ -0,0 +1,9 @@
+# Nx 14.5
+
+[Read the 14.5 release blog post](https://blog.nrwl.io/nx-14-5-cypess-v10-output-globs-linter-perf-react-tailwind-support-c15f0b5dc2fc)
+
+Here are some of our feature highlights:
+
+{% cards cols="2" %}
+{% card title="Support for Cypress 10"  type="video" url="https://youtu.be/QDWN4C7T-Ck" /%}
+{% /cards %}
diff --git a/docs/changelog/15_0_0.md b/docs/changelog/15_0_0.md
index e63471cbae..aea32e4cc5 100644
--- a/docs/changelog/15_0_0.md
+++ b/docs/changelog/15_0_0.md
@@ -1,5 +1,17 @@
+# Nx 15.0
+
+[Read the 15.0 release blog post](https://blog.nrwl.io/whats-new-in-nx-15-7e14e1ff282d)
+
+Here are some of our feature highlights:
+
+{% cards cols="2" %}
+{% card title="Combine the Power of Nx Graph and Nx Console"  type="video" url="https://youtu.be/ZST_rmhzRXI" /%}
+{% /cards %}
+
 ## Breaking Changes
 
+Use [the `nx migrate` command](/core-features/automate-updating-dependencies) to automatically account for these breaking changes.
+
 {% cards cols="2" %}
 {% card title="Removed UMD format support for rollup" type="external" url="https://github.com/nrwl/nx/pull/12426" /%}
 {% card title="Removed --only-failed option" type="external" url="https://github.com/nrwl/nx/pull/12471" /%}
diff --git a/docs/changelog/15_3_0.md b/docs/changelog/15_3_0.md
new file mode 100644
index 0000000000..d62665e75a
--- /dev/null
+++ b/docs/changelog/15_3_0.md
@@ -0,0 +1,17 @@
+# Nx 15.3
+
+[Read the 15.3 release blog post](https://blog.nrwl.io/nx-15-3-standalone-projects-vite-task-graph-and-more-3ed23f7827ed)
+
+{% youtube
+src="https://www.youtube.com/embed/KBFQZw5ynFs"
+title="What&#39;s new in Nx 15.3?"
+width="100%" /%}
+Here are some of our feature highlights:
+
+{% cards cols="2" %}
+{% card title="Introducing the Nx Task Graph Visualization"  type="video" url="https://youtu.be/wOE3r4299fs" /%}
+{% card title="Standalone Applications with Nx"  type="video" url="https://youtu.be/qEaVzh-oBBc" /%}
+{% card title="Add Nx to any Project"  type="video" url="https://youtu.be/VmGCZ77ao_I" /%}
+{% card title="Run Root-level NPM Scripts with Nx"  type="video" url="https://youtu.be/PRURABLaS8s" /%}
+{% card title="Wrap Any Command with Nx Run-Commands"  type="video" url="https://youtu.be/iygb-KhAeik" /%}
+{% /cards %}
diff --git a/docs/changelog/15_4_0.md b/docs/changelog/15_4_0.md
new file mode 100644
index 0000000000..db59088b01
--- /dev/null
+++ b/docs/changelog/15_4_0.md
@@ -0,0 +1,13 @@
+# Nx 15.4
+
+[Read the 15.4 release blog post](https://blog.nrwl.io/nx-15-4-vite-4-support-a-new-nx-watch-command-and-more-77cbf6c9a711)
+
+{% youtube
+src="https://www.youtube.com/embed/G02THNy3PcE"
+title="Nx 15.4 is out! Here&#39;s all you need to know"
+width="100%" /%}
+Here are some of our feature highlights:
+
+{% cards cols="2" %}
+{% card title="One Command to Run Multiple Tasks in Parallel"  type="video" url="https://youtu.be/ROTO89i5m_4" /%}
+{% /cards %}
diff --git a/docs/changelog/15_7_0.md b/docs/changelog/15_7_0.md
new file mode 100644
index 0000000000..720965cb2a
--- /dev/null
+++ b/docs/changelog/15_7_0.md
@@ -0,0 +1,16 @@
+# Nx 15.7
+
+[Read the 15.7 release blog post](https://blog.nrwl.io/nx-15-7-node-support-angular-lts-lockfile-pruning-46f067090711)
+
+{% youtube
+src="https://www.youtube.com/embed/IStJODzZSoc"
+title="What's new in Nx 15.7?"
+width="100%" /%}
+Here are some of our feature highlights:
+
+{% cards cols="2" %}
+{% card title="Build Node Backends - The Easy Way!"  type="video" url="https://youtu.be/K4f-fMuAoRY" /%}
+{% card title="Angular LTS Support Starting with Nx 15.7"  type="video" url="https://youtu.be/AQV4WFldwlY" /%}
+{% card title="Create NgModule Free Angular Apps"  type="video" url="https://youtu.be/Hi3aJ0Rlkls" /%}
+{% card title="More Flexible Webpack Configs"  type="video" url="https://youtu.be/CIT4MFMraXg" /%}
+{% /cards %}
diff --git a/docs/changelog/15_8_0.md b/docs/changelog/15_8_0.md
new file mode 100644
index 0000000000..eb0ed76961
--- /dev/null
+++ b/docs/changelog/15_8_0.md
@@ -0,0 +1,16 @@
+# Nx 15.8
+
+[Read the 15.8 release blog post](https://blog.nrwl.io/nx-15-8-rust-hasher-nx-console-for-intellij-deno-node-and-storybook-aa2b8585772e)
+
+{% youtube
+src="https://www.youtube.com/embed/4XdHT5Y7zj4"
+title="Nx 15.8 - All you need to know!"
+width="100%" /%}
+Here are some of our feature highlights:
+
+{% cards cols="2" %}
+{% card title="NEW!!! Nx Deno Plugin"  type="video" url="https://youtu.be/NpH8cFSp51E" /%}
+{% card title="Nx Console Goes Poly-IDE"  type="video" url="https://youtu.be/xUTm6GDqwJM" /%}
+{% card title="Prioritized Params in Nx Console"  type="video" url="https://youtu.be/JJ12zKedwIs" /%}
+{% card title="Easy, Modular Node Applications!"  type="video" url="https://youtu.be/LHLW0b4fr2w" /%}
+{% /cards %}
diff --git a/docs/changelog/16_0_0.md b/docs/changelog/16_0_0.md
index c7866476c0..774164b11d 100644
--- a/docs/changelog/16_0_0.md
+++ b/docs/changelog/16_0_0.md
@@ -20,7 +20,7 @@ Here are some of our feature highlights:
 ## Deprecations
 
 {% cards cols="2" %}
-{% card title="workspace-lint" type="external" url="https://github.com/nrwl/nx/pull/16385" /%}
+{% card title="workspace-lint" type="document" url="/deprecated/workspace-lint" /%}
 {% card title="module federation utils from devkit public api" type="external" url="https://github.com/nrwl/nx/pull/16574" /%}
 {% card title="Global implicitDependencies" url="/deprecated/global-implicit-dependencies" /%}
 {% card title="stylus style option for react and next" type="external" url="https://github.com/nrwl/nx/pull/16135" /%}
@@ -29,6 +29,8 @@ Here are some of our feature highlights:
 
 ## Breaking Changes
 
+Use [the `nx migrate` command](/core-features/automate-updating-dependencies) to automatically account for these breaking changes.
+
 {% cards cols="2" %}
 {% card title="Removed @nrwl/cypress/plugins/preprocessor" type="external" url="https://github.com/nrwl/nx/pull/16170" /%}
 {% card title="Removed simpleModuleName option from Angular library" type="external" url="https://github.com/nrwl/nx/pull/16219" /%}
diff --git a/docs/changelog/16_4_0.md b/docs/changelog/16_4_0.md
new file mode 100644
index 0000000000..828942c3e5
--- /dev/null
+++ b/docs/changelog/16_4_0.md
@@ -0,0 +1,7 @@
+## Deprecations
+
+{% cards cols="2" %}
+{% card title="cypress tsconfig option" type="external" url="https://github.com/nrwl/nx/pull/17165" /%}
+{% card title="print-affected" type="external" url="https://github.com/nrwl/nx/pull/17341" /%}
+{% card title="affected:graph" type="external" url="https://github.com/nrwl/nx/pull/17341" /%}
+{% /cards %}
diff --git a/docs/generated/manifests/menus.json b/docs/generated/manifests/menus.json
index 6e2c9eec74..469a9a7b55 100644
--- a/docs/generated/manifests/menus.json
+++ b/docs/generated/manifests/menus.json
@@ -1443,6 +1443,14 @@
             "isExternal": false,
             "children": [],
             "disableCollapsible": false
+          },
+          {
+            "name": "Changelog",
+            "path": "/reference/changelog",
+            "id": "changelog",
+            "isExternal": true,
+            "children": [],
+            "disableCollapsible": false
           }
         ],
         "disableCollapsible": false
@@ -1511,6 +1519,14 @@
         "children": [],
         "disableCollapsible": false
       },
+      {
+        "name": "Changelog",
+        "path": "/reference/changelog",
+        "id": "changelog",
+        "isExternal": true,
+        "children": [],
+        "disableCollapsible": false
+      },
       {
         "name": "Deprecated",
         "path": "/deprecated",
diff --git a/docs/generated/manifests/nx.json b/docs/generated/manifests/nx.json
index 988d65dc1d..3b683d093f 100644
--- a/docs/generated/manifests/nx.json
+++ b/docs/generated/manifests/nx.json
@@ -1796,6 +1796,16 @@
         "isExternal": false,
         "path": "/reference/glossary",
         "tags": []
+      },
+      {
+        "id": "changelog",
+        "name": "Changelog",
+        "description": "",
+        "file": "",
+        "itemList": [],
+        "isExternal": true,
+        "path": "/reference/changelog",
+        "tags": []
       }
     ],
     "isExternal": false,
@@ -1882,6 +1892,16 @@
     "path": "/reference/glossary",
     "tags": []
   },
+  "/reference/changelog": {
+    "id": "changelog",
+    "name": "Changelog",
+    "description": "",
+    "file": "",
+    "itemList": [],
+    "isExternal": true,
+    "path": "/reference/changelog",
+    "tags": []
+  },
   "/deprecated": {
     "id": "deprecated",
     "name": "Deprecated",
diff --git a/docs/map.json b/docs/map.json
index d822383301..7e66b21c67 100644
--- a/docs/map.json
+++ b/docs/map.json
@@ -583,6 +583,13 @@
               "id": "glossary",
               "tags": [],
               "file": "shared/reference/glossary"
+            },
+            {
+              "name": "Changelog",
+              "id": "changelog",
+              "file": "",
+              "path": "/reference/changelog",
+              "isExternal": true
             }
           ]
         },
diff --git a/nx-dev/nx-dev/pages/[...segments].tsx b/nx-dev/nx-dev/pages/[...segments].tsx
index a58f7cdf20..dd53cf1e9a 100644
--- a/nx-dev/nx-dev/pages/[...segments].tsx
+++ b/nx-dev/nx-dev/pages/[...segments].tsx
@@ -80,7 +80,12 @@ export default function NxDocumentation({
 }
 
 export const getStaticPaths: GetStaticPaths = () => {
-  const reservedPaths = ['/recipes', '/nx-cloud', '/packages'];
+  const reservedPaths = [
+    '/recipes',
+    '/nx-cloud',
+    '/packages',
+    '/reference/changelog',
+  ];
   return {
     paths: nxDocumentationApi
       .getSlugsStaticDocumentPaths()
diff --git a/nx-dev/nx-dev/pages/changelog.tsx b/nx-dev/nx-dev/pages/reference/changelog.tsx
similarity index 89%
rename from nx-dev/nx-dev/pages/changelog.tsx
rename to nx-dev/nx-dev/pages/reference/changelog.tsx
index 7dbf90ee93..8df1e75b21 100644
--- a/nx-dev/nx-dev/pages/changelog.tsx
+++ b/nx-dev/nx-dev/pages/reference/changelog.tsx
@@ -1,12 +1,21 @@
 import { TagIcon } from '@heroicons/react/24/outline';
-import { Footer, Header } from '@nx/nx-dev/ui-common';
+import {
+  Breadcrumbs,
+  DocumentationHeader,
+  Footer,
+  SidebarContainer,
+} from '@nx/nx-dev/ui-common';
 import { renderMarkdown } from '@nx/nx-dev/ui-markdoc';
 import { cx } from '@nx/nx-dev/ui-primitives';
 import { NextSeo } from 'next-seo';
 import { useRouter } from 'next/router';
 import { Octokit } from 'octokit';
 import { compare, parse } from 'semver';
-import { changeLogApi } from '../lib/changelog.api';
+import { changeLogApi } from '../../lib/changelog.api';
+import { useNavToggle } from '../../lib/navigation-toggle.effect';
+import { menusApi } from '../../lib/menus.api';
+import { MenuItem } from '@nx/nx-dev/models-menu';
+import { getBasicNxSection } from '@nx/nx-dev/data-access-menu';
 
 interface ChangelogEntry {
   version: string;
@@ -19,6 +28,7 @@ interface ChangelogEntry {
 
 interface ChangeLogProps {
   changelog: ChangelogEntry[];
+  menu: MenuItem[];
 }
 
 interface GithubReleaseData {
@@ -153,6 +163,7 @@ export async function getStaticProps(): Promise<{ props: ChangeLogProps }> {
   return {
     props: {
       changelog: groupedReleases,
+      menu: menusApi.getMenu('nx', ''),
     },
   };
 }
@@ -178,6 +189,11 @@ export default function Changelog(props: ChangeLogProps): JSX.Element {
   });
   const convertToDate = (invalidDate) =>
     new Date(invalidDate.replace(/(nd|th|rd)/g, ''));
+  const { toggleNav, navIsOpen } = useNavToggle();
+
+  const menu = {
+    sections: [getBasicNxSection(props.menu)],
+  };
 
   return (
     <>
@@ -201,10 +217,19 @@ export default function Changelog(props: ChangeLogProps): JSX.Element {
           type: 'website',
         }}
       />
-      <Header />
+      <div className="w-full flex-shrink-0">
+        <DocumentationHeader isNavOpen={navIsOpen} toggleNav={toggleNav} />
+      </div>
+
       <main id="main" role="main">
-        <div className="mx-auto flex max-w-7xl flex-col space-y-12 py-12 px-4 sm:px-6 lg:space-y-0 lg:py-16 lg:px-8">
-          <header className="space-y-4 md:py-12">
+        <div className="mx-auto flex max-w-7xl flex-col py-8 px-4 sm:px-6 lg:px-8">
+          <div className="mb-6">
+            <Breadcrumbs path={router.asPath} />
+          </div>
+          <div className="hidden">
+            <SidebarContainer menu={menu} navIsOpen={navIsOpen} />
+          </div>
+          <header className="mt-0">
             <h1 className="text-3xl font-semibold tracking-tight text-slate-900 dark:text-slate-100 sm:text-5xl">
               Nx Changelog
             </h1>
@@ -212,7 +237,7 @@ export default function Changelog(props: ChangeLogProps): JSX.Element {
               All the Nx goodies in one page, sorted by release.
             </p>
           </header>
-          <ul role="list" className="m-0 space-y-6">
+          <ul className="m-0 space-y-6 py-6">
             {renderedChangelog.map((changelog, idx) => (
               <li key={changelog.version} className="relative sm:flex gap-x-4">
                 <div