Improve Model SDK tutorial

Author: ahmed-negm

content/en/docs/apidocs-mxsdk/mxsdk/sdk-howtos/creating-your-first-script.md

@@ -92,24 +92,20 @@ Once you are done with the model changes, you can flush the changes to make sure
 
 ## Compiling and Running the Script
 
-1. Compile the script with the TypeScript compiler into JavaScript using the following command:
+1. Add the following section to `package.json` 
 
-    ```bash
-    $ tsc
+    ```json
+    "scripts": {
+        "start": "tsc && node script.js"
+    }
     ```
 
-    A file named `script.js` should appear (or, if you named the original TypeScript file for example, `app.ts`, then it would be named `app.js`.
-
-    The TypeScript compiler will execute in a single run to compile all files configured in *tsconfig.json*. While developing your script, it can be practical to have the compiler immediately run once you make changes to your code. Use the `--watch` flag for `tsc` to monitor the files configured in the *tsconfig.json* file for changes and immediately run the compiler when you save the file:
-
-    ```bash
-    $ tsc --watch
-    ```
+    This command will first compile your TypeScript code into JavaScript using the TypeScript compiler. After compilation, a file named `script.js` will be generated. The script will then be executed using Node.js.
 
-2. Run the script with `node` to see the results:
+2. Run the script to see the results:
 
     ```text
-    $ node script.js
+    $ npm run start
     Creating new app 'NewApp-1637595970665'...
     Successfully created app with id '64760e41-9507-42d3-99da-3950454dd40a'
     Creating temporary working copy for branch 'main'...

content/en/docs/apidocs-mxsdk/mxsdk/sdk-howtos/setting-up-your-development-environment.md

@@ -19,10 +19,10 @@ Set up a new `node` project and install the dependencies using the following ste
 $ mkdir my-app-generator
 $ cd my-app-generator
 $ npm init --yes
-$ npm install -g typescript
 $ npm install mendixmodelsdk mendixplatformsdk --save
-$ tsc --init --target es2020
+$ npm install typescript@~4.6.2 @types/node@~22.0.3 --save-dev
 ```
+You can now proceed directly to step 6 in the detailed instructions to configure TypeScript.
 
 ## Setting Up Your Development Tools {#setting}
 
@@ -34,28 +34,15 @@ To set up your development tools, follow these steps:
 
     ```bash
     $ node --version
-    v18.20.8
+    v22.15.0
     ```
 
     For Debian-based Linux distributions such as Ubuntu, please refer to [NodeSource Node.js Binary Distributions](https://github.com/nodesource/distributions#user-content-installation-instructions) to properly set up your apt-get sources.
 
     In the rest of the how-tos, in blocks such as the above, lines starting with a `$` represent commands to type into a terminal. Sometimes a line follows without a $, represents output of the command.
 
 3. Install [Visual Studio Code](https://code.visualstudio.com/) (not to be confused with Visual Studio), a text editor/IDE with good support for [TypeScript](https://www.typescriptlang.org/). Make sure you have a recent version (v1.11.0+); check the version you are using through Help > About when you have Code opened.
-4. Install TypeScript 4.6.2 or higher with [`npm`](https://www.npmjs.com/) (or [`yarn`](https://yarnpkg.com/)), Node.js's package manager:
 
-    ```bash
-    $ npm install -g typescript
-    ```
-
-5. Use the following command to check the TypeScript compiler version on your PATH:
-
-    ```bash
-    $ tsc --version
-    Version 4.6.2 (or higher)
-    ```
-
-    If the version number is much lower, it could be that you also have an outdated TypeScript SDK on your system, left over from a previous installation. You can either uninstall the old TypeScript SDK, or bypass it by removing the old TypeScript SDK from your system's PATH environment variable.
 
 ## Setting Up a Working Directory for Your Script
 
@@ -82,33 +69,44 @@ To set up a working directory for your script, follow these steps:
 
     ```json
     "dependencies": {
-      "mendixmodelsdk": "^4.56.0",
-      "mendixplatformsdk": "^5.0.0"
+      "mendixmodelsdk": "^4.102.0",
+      "mendixplatformsdk": "^5.2.0"
     }
     ```
 
     When a new major version of the Mendix SDK is released (as in, 1.0.0 to 2.0.0) and you run `npm update` in your project folder, the `^` in front of the version number makes sure that the installed version of the SDK will not be upgraded automatically. Only minor and patch releases (as in, 1.1.1) of the SDK will be automatically upgraded; otherwise, your script could inadvertently be broken. You may, of course, edit the dependency by hand yourself.
 
-4. Save your changes and then execute the following to install the dependencies:
+4. Add `typescript`, and `@types/node` as dev dependencies. 
+    Packages like TypeScript, testing libraries, linters, and type definitions (@types/...) are not required for your app to run in production—they're only needed while writing and testing code.
+
+    ```json
+    "devDependencies": {
+      "typescript": "~4.6.2",
+      "@types/node": "~22.0.3"
+    }
+    ```
+
+5. Save your changes and then execute the following to install the dependencies:
 
     ```bash
     $ npm install
     ```
 
     If you are using version control, make sure to ignore the `node_modules` directory, otherwise you end up committing dependencies.
 
-5. In Code, create a [tsconfig.json](https://www.typescriptlang.org/docs/handbook/tsconfig-json.html) file next to your *package.json*. The *tsconfig.json* file is used by the TypeScript compiler to compile your code in the proper manner to a JS file. Create it with the following contents. 
+6. In Code, create a [tsconfig.json](https://www.typescriptlang.org/docs/handbook/tsconfig-json.html) file next to your *package.json*. The *tsconfig.json* file is used by the TypeScript compiler to compile your code in the proper manner to a JS file. Create it with the following contents. 
 
     ```json
     {
-    	"compilerOptions" : {
-    		"module" : "commonjs",
-    		"target" : "es2020",
-            "strict": true
-    	},
-    	"files" : [
-    		"script.ts"
-    	]
+    "compilerOptions": {
+        "target": "es2020",
+        "module": "commonjs",
+        "esModuleInterop": true,
+        "forceConsistentCasingInFileNames": true,
+        "strict": true,
+        "skipLibCheck": true
+    },
+    "files": ["script.ts"]
     }
     ```