From 2cd62ff669b8b7ca079af1b497b4c31ce209dd58 Mon Sep 17 00:00:00 2001 From: Juri Date: Wed, 30 Oct 2024 23:27:03 +0100 Subject: [PATCH] docs(core): add intro to Nx course --- docs/courses/explore-nx/course.md | 7 +++++++ docs/courses/explore-nx/lessons/01-why-nx.md | 19 +++++++++++++++++++ .../explore-nx/lessons/02-run-tasks.md | 14 ++++++++++++++ .../lessons/03-cache-task-results.md | 12 ++++++++++++ .../explore-nx/lessons/04-generate-code.md | 13 +++++++++++++ .../05-automate-updating-dependencies.md | 13 +++++++++++++ docs/courses/pnpm-nx-next/course.md | 3 +-- 7 files changed, 79 insertions(+), 2 deletions(-) create mode 100644 docs/courses/explore-nx/course.md create mode 100644 docs/courses/explore-nx/lessons/01-why-nx.md create mode 100644 docs/courses/explore-nx/lessons/02-run-tasks.md create mode 100644 docs/courses/explore-nx/lessons/03-cache-task-results.md create mode 100644 docs/courses/explore-nx/lessons/04-generate-code.md create mode 100644 docs/courses/explore-nx/lessons/05-automate-updating-dependencies.md diff --git a/docs/courses/explore-nx/course.md b/docs/courses/explore-nx/course.md new file mode 100644 index 00000000000000..14443cc1fb41c1 --- /dev/null +++ b/docs/courses/explore-nx/course.md @@ -0,0 +1,7 @@ +--- +title: 'Introduction to Nx' +description: 'New to Nx? Then this is where you should start.' +authors: [Juri Strumpflohner] +--- + +This course gives you a quick high-level overview of Nx, how running tasks works, task caching, how Nx provides code scaffolding functionality and how you can use `nx migrate` to automatically update your workspace dependencies and code across breaking changes. diff --git a/docs/courses/explore-nx/lessons/01-why-nx.md b/docs/courses/explore-nx/lessons/01-why-nx.md new file mode 100644 index 00000000000000..13868e98cea4bf --- /dev/null +++ b/docs/courses/explore-nx/lessons/01-why-nx.md @@ -0,0 +1,19 @@ +--- +title: 'Soo..what is Nx?' +videoUrl: 'https://youtu.be/-_4WMl-Fn0w' +duration: '9:28' +--- + +This video gives you a birds-eye view of Nx in ~10 minutes. It covers topics such as: + +- What is Nx +- Nx Architecture +- Add Nx to an arbitrary project +- Why would adding Nx be useful? +- Nx in a PNPM monorepo +- Why use Nx Plugins +- Setting up a new Nx Integrated Monorepo +- Abstracting low-level configs +- Automated Code Updates + +Read more [in our docs](/getting-started/why-nx) diff --git a/docs/courses/explore-nx/lessons/02-run-tasks.md b/docs/courses/explore-nx/lessons/02-run-tasks.md new file mode 100644 index 00000000000000..abd42ceb062f0d --- /dev/null +++ b/docs/courses/explore-nx/lessons/02-run-tasks.md @@ -0,0 +1,14 @@ +--- +title: 'Run Tasks with Nx' +videoUrl: 'https://youtu.be/aEdfYiA5U34' +duration: '4:19' +--- + +Learn how Nx provides a powerful task runner that allows you to: + +- easily run multiple targets for multiple projects in parallel +- define task pipelines to run tasks in the correct order +- only run tasks for projects affected by a given change +- speed up task execution with caching + +Read more [in our docs](/features/run-tasks) diff --git a/docs/courses/explore-nx/lessons/03-cache-task-results.md b/docs/courses/explore-nx/lessons/03-cache-task-results.md new file mode 100644 index 00000000000000..9491d3b21f84a0 --- /dev/null +++ b/docs/courses/explore-nx/lessons/03-cache-task-results.md @@ -0,0 +1,12 @@ +--- +title: 'Cache Task Results' +videoUrl: 'https://youtu.be/o-6jb78uuP0' +duration: '8:50' +--- + +Learn how Nx's sophisticated caching system ensures code is never rebuilt twice. This: + +- drastically speeds up your task execution times while developing locally and in CI +- saves you money on CI/CD costs by reducing the number of tasks that need to be executed + +Read more [in our docs](/features/cache-task-results) diff --git a/docs/courses/explore-nx/lessons/04-generate-code.md b/docs/courses/explore-nx/lessons/04-generate-code.md new file mode 100644 index 00000000000000..72d96151e4c98d --- /dev/null +++ b/docs/courses/explore-nx/lessons/04-generate-code.md @@ -0,0 +1,13 @@ +--- +title: 'Generate Code' +videoUrl: 'https://youtu.be/hSM6MgWOYr8' +duration: '4:11' +--- + +Learn how Nx's code generators help boost your productivity by: + +- Allowing you to scaffold new projects or augment existing projects with new features +- Automating repetitive tasks in your development workflow +- Ensuring your code is consistent and follows best practices + +Read more [in our docs](/features/generate-code) diff --git a/docs/courses/explore-nx/lessons/05-automate-updating-dependencies.md b/docs/courses/explore-nx/lessons/05-automate-updating-dependencies.md new file mode 100644 index 00000000000000..4f6231e105926e --- /dev/null +++ b/docs/courses/explore-nx/lessons/05-automate-updating-dependencies.md @@ -0,0 +1,13 @@ +--- +title: 'Automate Updating Dependencies' +videoUrl: 'https://youtu.be/A0FjwsTlZ8A' +duration: '4:45' +--- + +Learn how Nx migrate functionality helps you: + +- automatically update your package.json dependencies +- migrate your configuration files (e.g. Jest, ESLint, Nx config) +- adjust your source code to match the new versions of packages + +Read more [in our docs](/features/automate-updating-dependencies) diff --git a/docs/courses/pnpm-nx-next/course.md b/docs/courses/pnpm-nx-next/course.md index 5c0f2d593fe9b2..0676563ab0c80e 100644 --- a/docs/courses/pnpm-nx-next/course.md +++ b/docs/courses/pnpm-nx-next/course.md @@ -1,7 +1,6 @@ --- title: 'From PNPM Workspaces to Distributed CI' -description: '' -slug: nx-19-8-update +description: 'Learn how to transform a PNPM workspace monorepo into a high-performance distributed CI setup using Nx.' authors: [Juri Strumpflohner] repository: 'https://github.com/nrwl/nx-course-pnpm-nx' ---