Skip to content

Commit 6ca1110

Browse files
matz3KlattG
andauthored
docs: Add 'Local Development Environment' instructions (#1222)
JIRA: CPOUI5FOUNDATION-1160 Co-authored-by: Günter Klatt <[email protected]>
1 parent 3cdd53a commit 6ca1110

File tree

2 files changed

+37
-4
lines changed

2 files changed

+37
-4
lines changed

docs/Guidelines.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,37 @@
11
# Development Conventions and Guidelines
2+
## Local Development Environment
3+
You can use any IDE or text editor of your choice. There are no specific requirements or additions for a particular IDE.
4+
5+
### Prerequisites
6+
7+
- [Node.js](https://nodejs.org/): See the `engines` section in [package.json](../package.json) for the required version.
8+
- [npm](https://www.npmjs.com/): This comes with Node.js.
9+
10+
UI5 CLI is tested on Windows, macOS, and Linux. As some tools and scripts require a Unix-like shell environment, we recommend using [Git Bash](https://git-scm.com/install/windows) on Windows.
11+
12+
### Installation
13+
14+
1. Clone the repository and navigate into it:
15+
```sh
16+
git clone https://github.com/UI5/cli.git
17+
cd cli
18+
```
19+
2. Install all dependencies in the repository (npm workspace):
20+
```sh
21+
npm install
22+
```
23+
3. *(Optional)* If you want to test the CLI locally, link the package to make the `ui5` command available globally:
24+
```sh
25+
npm link --workspace @ui5/cli
26+
```
27+
**Note:** You might need to set the environment variable `UI5_CLI_NO_LOCAL` to `X` (or any value) to avoid invoking a local installation of UI5 CLI in your current working directory.
28+
29+
You can remove the global link using:
30+
```sh
31+
npm uninstall --global @ui5/cli
32+
```
33+
If you remove the link and previously installed UI5 CLI globally using `npm install --global @ui5/cli`, you need to re-install it.
34+
235
## JavaScript Coding Guidelines
336
We enforce code style rules using [ESLint](https://eslint.org). Execute `npm run lint` to check your code for style issues.
437
You may also find an ESLint integration for your favorite IDE [here](https://eslint.org/docs/user-guide/integrations).

internal/documentation/docs/pages/Benchmarking.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -12,17 +12,17 @@ The following is a walk-through on how to evaluate the performance impact of cha
1212
2. Prepare the UI5 CLI repository *(optional if your development environment already reflects this)*:
1313
1. Clone [UI5 CLI](https://github.com/UI5/cli) (or your fork) and navigate into it
1414
```sh
15-
git clone git@github.com:UI5/cli.git
15+
git clone https://github.com/UI5/cli.git
1616
cd cli
1717
```
1818
Make sure you check out the `main` branch, since we'll perform the baseline test first
19-
2. Install npm dependencies
19+
2. Install all dependencies in the repository (npm workspace):
2020
```sh
2121
npm install
2222
```
23-
3. Create a global npm link for `@ui5/cli`
23+
3. Link the `@ui5/cli` package to make the `ui5` command available globally
2424
```sh
25-
(cd packages/cli && npm link)
25+
npm link --workspace @ui5/cli
2626
```
2727
4. Verify your setup
2828
```sh

0 commit comments

Comments
 (0)