From f9d4358363d4c632983db54d2a8230ad1c41cad9 Mon Sep 17 00:00:00 2001 From: maliming Date: Tue, 3 Dec 2024 18:23:12 +0800 Subject: [PATCH 1/3] Update pre-requirements in the documents. --- .../ui/mvc-razor-pages/client-side-package-management.md | 2 +- docs/en/get-started/layered-web-application.md | 4 ++-- docs/en/get-started/single-layer-web-application.md | 4 ++-- docs/en/samples/easy-crm.md | 2 +- docs/en/studio/installation.md | 2 +- docs/en/tutorials/book-store/part-01.md | 2 +- docs/en/tutorials/todo/layered/index.md | 4 ++-- docs/en/tutorials/todo/single-layer/index.md | 4 ++-- templates/app-nolayers/aspnet-core/README.md | 4 ++-- templates/app/aspnet-core/README.md | 4 ++-- 10 files changed, 16 insertions(+), 16 deletions(-) diff --git a/docs/en/framework/ui/mvc-razor-pages/client-side-package-management.md b/docs/en/framework/ui/mvc-razor-pages/client-side-package-management.md index bb984a001f..31e54079ba 100644 --- a/docs/en/framework/ui/mvc-razor-pages/client-side-package-management.md +++ b/docs/en/framework/ui/mvc-razor-pages/client-side-package-management.md @@ -41,7 +41,7 @@ After depending on a NPM package, all you should do is to run the **yarn** comma yarn ``` -Alternatively, you can use `npm install` but [Yarn](https://classic.yarnpkg.com/) is suggested as mentioned before. +Alternatively, you can use `npm install` but [Yarn v1.22+ (not v2)](https://classic.yarnpkg.com/en/docs/install) is suggested as mentioned before. #### Package Contribution diff --git a/docs/en/get-started/layered-web-application.md b/docs/en/get-started/layered-web-application.md index ba10187aef..8e8f4d51ce 100644 --- a/docs/en/get-started/layered-web-application.md +++ b/docs/en/get-started/layered-web-application.md @@ -19,10 +19,10 @@ First things first! Let's setup your development environment before creating the The following tools should be installed on your development machine: -* [Visual Studio 2022](https://visualstudio.microsoft.com/vs/) (v17.3+) for Windows / [Visual Studio for Mac](https://visualstudio.microsoft.com/vs/mac/). [1](#f-editor) +* [Visual Studio 2022](https://visualstudio.microsoft.com/) or another IDE that supports [.NET 9.0+](https://dotnet.microsoft.com/download/dotnet) development. [1](#f-editor) * [.NET 9.0+](https://dotnet.microsoft.com/en-us/download/dotnet) {{ if UI != "Blazor" }} -* [Node v18.19+](https://nodejs.org/) +* [Node v22+](https://nodejs.org/) * [Yarn v1.22+ (not v2)](https://classic.yarnpkg.com/en/docs/install) [2](#f-yarn) or npm v10+ (already installed with Node) {{ end }} {{ if Tiered == "Yes" }} diff --git a/docs/en/get-started/single-layer-web-application.md b/docs/en/get-started/single-layer-web-application.md index 02fbaa276e..3029bba280 100644 --- a/docs/en/get-started/single-layer-web-application.md +++ b/docs/en/get-started/single-layer-web-application.md @@ -18,10 +18,10 @@ First things first! Let's setup your development environment before creating the The following tools should be installed on your development machine: -* [Visual Studio 2022](https://visualstudio.microsoft.com/vs/) (v17.3+) for Windows / [Visual Studio for Mac](https://visualstudio.microsoft.com/vs/mac/). [1](#f-editor) +* [Visual Studio 2022](https://visualstudio.microsoft.com/) or another IDE that supports [.NET 9.0+](https://dotnet.microsoft.com/download/dotnet) development. [1](#f-editor) * [.NET 9.0+](https://dotnet.microsoft.com/en-us/download/dotnet) {{ if UI != "Blazor" }} -* [Node v18.19+](https://nodejs.org/) +* [Node v22+](https://nodejs.org/) * [Yarn v1.22+ (not v2)](https://classic.yarnpkg.com/en/docs/install) [2](#f-yarn) or npm v10+ (already installed with Node) {{ end }} {{ if Tiered == "Yes" }} diff --git a/docs/en/samples/easy-crm.md b/docs/en/samples/easy-crm.md index 480aa80316..1a0fff3b3f 100644 --- a/docs/en/samples/easy-crm.md +++ b/docs/en/samples/easy-crm.md @@ -35,7 +35,7 @@ When you download and open the zip file, you will see two folders: * First, follow all the steps above to run the server side and seed the sample data. * Open a command prompt in the angular folder. -* Run the `yarn` command to install NPM packages (requires the [Yarn](https://yarnpkg.com/) package manager). +* Run the `yarn` command to install NPM packages (requires the [Yarn v1.22+ (not v2)](https://classic.yarnpkg.com/en/docs/install) package manager). * Run the `yarn start` command to run the Angular application. It will automatically open the `localhost://4200` in your default browser once the application initialized. ### Blazor UI diff --git a/docs/en/studio/installation.md b/docs/en/studio/installation.md index 2cc3452533..34dde8a5c9 100644 --- a/docs/en/studio/installation.md +++ b/docs/en/studio/installation.md @@ -8,7 +8,7 @@ Before you begin the installation process for ABP Studio, ensure that your system meets the following pre-requirements: ### Node -Make sure [Node.js](https://nodejs.org/en) is installed on your system. If you have not installed Node.js, you can download the `v18.19+` version from the official [Node.js website](https://nodejs.org/en/download/prebuilt-installer). +Make sure [Node.js](https://nodejs.org/en) is installed on your system. If you have not installed Node.js, you can download the `v22+` version from the official [Node.js website](https://nodejs.org/en/download/prebuilt-installer). ### WireGuard (Optional) ABP Studio needs [WireGuard](https://www.wireguard.com/) for Kubernetes operations. You can find the installation instructions for your specific operating system below: diff --git a/docs/en/tutorials/book-store/part-01.md b/docs/en/tutorials/book-store/part-01.md index a808c36034..91700a1a25 100644 --- a/docs/en/tutorials/book-store/part-01.md +++ b/docs/en/tutorials/book-store/part-01.md @@ -34,7 +34,7 @@ For such cases, run the `abp install-libs` command on the root directory of your abp install-libs ``` -> We suggest you install [Yarn](https://classic.yarnpkg.com/) to prevent possible package inconsistencies, if you haven't installed it yet. +> We suggest you install [Yarn v1.22+ (not v2)](https://classic.yarnpkg.com/en/docs/install) to prevent possible package inconsistencies, if you haven't installed it yet. {{if UI=="Blazor" || UI=="BlazorWebApp"}} diff --git a/docs/en/tutorials/todo/layered/index.md b/docs/en/tutorials/todo/layered/index.md index e56d106a86..5babf74904 100644 --- a/docs/en/tutorials/todo/layered/index.md +++ b/docs/en/tutorials/todo/layered/index.md @@ -53,7 +53,7 @@ This documentation has a video tutorial on **YouTube**!! You can watch it here: ## Pre-Requirements * An IDE (e.g. [Visual Studio](https://visualstudio.microsoft.com/vs/)) that supports [.NET 9.0+](https://dotnet.microsoft.com/download/dotnet) development. -* [Node v18.19+](https://nodejs.org/) +* [Node v22+](https://nodejs.org/) {{if DB=="Mongo"}} @@ -111,7 +111,7 @@ For such cases, run the `abp install-libs` command on the root directory of your abp install-libs ```` -> We suggest you install [Yarn](https://classic.yarnpkg.com/) to prevent possible package inconsistencies, if you haven't installed it yet. +> We suggest you install [Yarn v1.22+ (not v2)](https://classic.yarnpkg.com/en/docs/install) to prevent possible package inconsistencies, if you haven't installed it yet. {{if UI=="Blazor" || UI=="BlazorWebApp"}} diff --git a/docs/en/tutorials/todo/single-layer/index.md b/docs/en/tutorials/todo/single-layer/index.md index 146a46694c..381ce05ec0 100644 --- a/docs/en/tutorials/todo/single-layer/index.md +++ b/docs/en/tutorials/todo/single-layer/index.md @@ -49,7 +49,7 @@ This documentation has a video tutorial on **YouTube**!! You can watch it here: ## Pre-Requirements * An IDE (e.g. [Visual Studio](https://visualstudio.microsoft.com/vs/)) that supports [.NET 9.0+](https://dotnet.microsoft.com/download/dotnet) development. -* [Node v18.19+](https://nodejs.org/) +* [Node v22+](https://nodejs.org/) {{if DB=="Mongo"}} @@ -113,7 +113,7 @@ Run the `abp install-libs` command on the root directory of your solution to ins abp install-libs ``` -> We suggest you install [Yarn](https://classic.yarnpkg.com/) to prevent possible package inconsistencies, if you haven't installed it yet. +> We suggest you install [Yarn v1.22+ (not v2)](https://classic.yarnpkg.com/en/docs/install) to prevent possible package inconsistencies, if you haven't installed it yet. {{if UI=="Blazor" || UI=="BlazorServer"}} diff --git a/templates/app-nolayers/aspnet-core/README.md b/templates/app-nolayers/aspnet-core/README.md index f5d8e22afa..266d477224 100644 --- a/templates/app-nolayers/aspnet-core/README.md +++ b/templates/app-nolayers/aspnet-core/README.md @@ -6,8 +6,8 @@ This is a minimalist, non-layered startup solution with the ABP Framework. All t ### Pre-requirements -* [.NET 8.0+ SDK](https://dotnet.microsoft.com/download/dotnet) -* [Node v18 or 20](https://nodejs.org/en) +* [.NET 9.0+ SDK](https://dotnet.microsoft.com/download/dotnet) +* [Node v22+](https://nodejs.org/en) ### Configurations diff --git a/templates/app/aspnet-core/README.md b/templates/app/aspnet-core/README.md index e9dc40663d..16ee179957 100644 --- a/templates/app/aspnet-core/README.md +++ b/templates/app/aspnet-core/README.md @@ -6,8 +6,8 @@ This is a layered startup solution based on [Domain Driven Design (DDD)](https:/ ### Pre-requirements -* [.NET 8.0+ SDK](https://dotnet.microsoft.com/download/dotnet) -* [Node v18 or 20](https://nodejs.org/en) +* [.NET 9.0+ SDK](https://dotnet.microsoft.com/download/dotnet) +* [Node v22+](https://nodejs.org/en) * [Redis](https://redis.io/) From a5e6dd11f3c4c6cd3ba78fcebcf405a6244033f5 Mon Sep 17 00:00:00 2001 From: masum-ulu Date: Tue, 3 Dec 2024 13:55:06 +0300 Subject: [PATCH 2/3] change min required version of nodejs --- docs/en/get-started/layered-web-application.md | 2 +- docs/en/get-started/single-layer-web-application.md | 2 +- docs/en/tutorials/todo/layered/index.md | 2 +- docs/en/tutorials/todo/single-layer/index.md | 2 +- templates/app-nolayers/aspnet-core/README.md | 2 +- templates/app/aspnet-core/README.md | 2 +- 6 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/en/get-started/layered-web-application.md b/docs/en/get-started/layered-web-application.md index 8e8f4d51ce..f35b1c39db 100644 --- a/docs/en/get-started/layered-web-application.md +++ b/docs/en/get-started/layered-web-application.md @@ -22,7 +22,7 @@ The following tools should be installed on your development machine: * [Visual Studio 2022](https://visualstudio.microsoft.com/) or another IDE that supports [.NET 9.0+](https://dotnet.microsoft.com/download/dotnet) development. [1](#f-editor) * [.NET 9.0+](https://dotnet.microsoft.com/en-us/download/dotnet) {{ if UI != "Blazor" }} -* [Node v22+](https://nodejs.org/) +* [Node v20.11+](https://nodejs.org/) * [Yarn v1.22+ (not v2)](https://classic.yarnpkg.com/en/docs/install) [2](#f-yarn) or npm v10+ (already installed with Node) {{ end }} {{ if Tiered == "Yes" }} diff --git a/docs/en/get-started/single-layer-web-application.md b/docs/en/get-started/single-layer-web-application.md index 3029bba280..9bcf2e0e7e 100644 --- a/docs/en/get-started/single-layer-web-application.md +++ b/docs/en/get-started/single-layer-web-application.md @@ -21,7 +21,7 @@ The following tools should be installed on your development machine: * [Visual Studio 2022](https://visualstudio.microsoft.com/) or another IDE that supports [.NET 9.0+](https://dotnet.microsoft.com/download/dotnet) development. [1](#f-editor) * [.NET 9.0+](https://dotnet.microsoft.com/en-us/download/dotnet) {{ if UI != "Blazor" }} -* [Node v22+](https://nodejs.org/) +* [Node v20.11+](https://nodejs.org/) * [Yarn v1.22+ (not v2)](https://classic.yarnpkg.com/en/docs/install) [2](#f-yarn) or npm v10+ (already installed with Node) {{ end }} {{ if Tiered == "Yes" }} diff --git a/docs/en/tutorials/todo/layered/index.md b/docs/en/tutorials/todo/layered/index.md index 5babf74904..a679bacac5 100644 --- a/docs/en/tutorials/todo/layered/index.md +++ b/docs/en/tutorials/todo/layered/index.md @@ -53,7 +53,7 @@ This documentation has a video tutorial on **YouTube**!! You can watch it here: ## Pre-Requirements * An IDE (e.g. [Visual Studio](https://visualstudio.microsoft.com/vs/)) that supports [.NET 9.0+](https://dotnet.microsoft.com/download/dotnet) development. -* [Node v22+](https://nodejs.org/) +* [Node v20.11+](https://nodejs.org/) {{if DB=="Mongo"}} diff --git a/docs/en/tutorials/todo/single-layer/index.md b/docs/en/tutorials/todo/single-layer/index.md index 381ce05ec0..c96c3715ef 100644 --- a/docs/en/tutorials/todo/single-layer/index.md +++ b/docs/en/tutorials/todo/single-layer/index.md @@ -49,7 +49,7 @@ This documentation has a video tutorial on **YouTube**!! You can watch it here: ## Pre-Requirements * An IDE (e.g. [Visual Studio](https://visualstudio.microsoft.com/vs/)) that supports [.NET 9.0+](https://dotnet.microsoft.com/download/dotnet) development. -* [Node v22+](https://nodejs.org/) +* [Node v20.11+](https://nodejs.org/) {{if DB=="Mongo"}} diff --git a/templates/app-nolayers/aspnet-core/README.md b/templates/app-nolayers/aspnet-core/README.md index 266d477224..5aa2ba5045 100644 --- a/templates/app-nolayers/aspnet-core/README.md +++ b/templates/app-nolayers/aspnet-core/README.md @@ -7,7 +7,7 @@ This is a minimalist, non-layered startup solution with the ABP Framework. All t ### Pre-requirements * [.NET 9.0+ SDK](https://dotnet.microsoft.com/download/dotnet) -* [Node v22+](https://nodejs.org/en) +* [Node v20.11+](https://nodejs.org/en) ### Configurations diff --git a/templates/app/aspnet-core/README.md b/templates/app/aspnet-core/README.md index 16ee179957..a35f23ea02 100644 --- a/templates/app/aspnet-core/README.md +++ b/templates/app/aspnet-core/README.md @@ -7,7 +7,7 @@ This is a layered startup solution based on [Domain Driven Design (DDD)](https:/ ### Pre-requirements * [.NET 9.0+ SDK](https://dotnet.microsoft.com/download/dotnet) -* [Node v22+](https://nodejs.org/en) +* [Node v20.11+](https://nodejs.org/en) * [Redis](https://redis.io/) From b0d8f312b79174b59fe80836fe06f4c126369c92 Mon Sep 17 00:00:00 2001 From: masum-ulu Date: Tue, 3 Dec 2024 14:06:55 +0300 Subject: [PATCH 3/3] update nodejs version in docs --- docs/en/framework/ui/angular/quick-start.md | 2 +- docs/en/framework/ui/react-native/index.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/en/framework/ui/angular/quick-start.md b/docs/en/framework/ui/angular/quick-start.md index 32e4522937..dec3a23262 100644 --- a/docs/en/framework/ui/angular/quick-start.md +++ b/docs/en/framework/ui/angular/quick-start.md @@ -6,7 +6,7 @@ Please follow the steps below to prepare your development environment for Angular. -1. **Install Node.js:** Please visit [Node.js downloads page](https://nodejs.org/en/download/) and download proper Node.js `v18.19+` installer for your OS. An alternative is to install [NVM](https://github.com/nvm-sh/nvm) and use it to have multiple versions of Node.js in your operating system. +1. **Install Node.js:** Please visit [Node.js downloads page](https://nodejs.org/en/download/) and download proper Node.js `v20.11+` installer for your OS. An alternative is to install [NVM](https://github.com/nvm-sh/nvm) and use it to have multiple versions of Node.js in your operating system. 2. **[Optional] Install Yarn:** You may install Yarn v1.22+ (not v2) following the instructions on [the installation page](https://classic.yarnpkg.com/en/docs/install). Yarn v1 delivers an arguably better developer experience compared to npm v10 and below. You may skip this step and work with npm, which is built-in in Node.js, instead. 3. **[Optional] Install VS Code:** [VS Code](https://code.visualstudio.com/) is a free, open-source IDE which works seamlessly with TypeScript. Although you can use any IDE including Visual Studio or Rider, VS Code will most likely deliver the best developer experience when it comes to Angular projects. ABP project templates even contain plugin recommendations for VS Code users, which VS Code will ask you to install when you open the Angular project folder. Here is a list of recommended extensions: - [Angular Language Service](https://marketplace.visualstudio.com/items?itemName=angular.ng-template) diff --git a/docs/en/framework/ui/react-native/index.md b/docs/en/framework/ui/react-native/index.md index 3dd60b6348..4b6a0b5ec7 100644 --- a/docs/en/framework/ui/react-native/index.md +++ b/docs/en/framework/ui/react-native/index.md @@ -17,7 +17,7 @@ ABP platform provide basic [React Native](https://reactnative.dev/) startup temp Please follow the steps below to prepare your development environment for React Native. -1. **Install Node.js:** Please visit [Node.js downloads page](https://nodejs.org/en/download/) and download proper Node.js v16 or v18 installer for your OS. An alternative is to install [NVM](https://github.com/nvm-sh/nvm) and use it to have multiple versions of Node.js in your operating system. +1. **Install Node.js:** Please visit [Node.js downloads page](https://nodejs.org/en/download/) and download proper Node.js v20.11+ installer for your OS. An alternative is to install [NVM](https://github.com/nvm-sh/nvm) and use it to have multiple versions of Node.js in your operating system. 2. **[Optional] Install Yarn:** You may install Yarn v1 (not v2) following the instructions on [the installation page](https://classic.yarnpkg.com/en/docs/install). Yarn v1 delivers an arguably better developer experience compared to npm v6 and below. You may skip this step and work with npm, which is built-in in Node.js, instead. 3. **[Optional] Install VS Code:** [VS Code](https://code.visualstudio.com/) is a free, open-source IDE which works seamlessly with TypeScript. Although you can use any IDE including Visual Studio or Rider, VS Code will most likely deliver the best developer experience when it comes to React Native projects. 4. **Install an Emulator:** React Native applications need an Android emulator or an iOS simulator to run on your OS. See the [Android Studio Emulator](https://docs.expo.io/workflow/android-simulator/) or [iOS Simulator](https://docs.expo.io/workflow/ios-simulator/) on expo.io documentation to learn how to set up an emulator.