Completed the descriptions in the example README.md how to execute the examples (#1889)

Author: JohannesMeierSE

examples/arithmetics/README.md

@@ -4,8 +4,24 @@
 
 The Arithmetics Example features an interpreter that you can run via cli.
 
-* Ensure the complete project was properly built, otherwise run `npm install` from the root of the Langium project.
-* Use `node ./bin/cli` from the arithmetics directory to run the cli. Follow the instructions or use `node ./bin/cli eval <full-path-to-calc-file>`.
+* Ensure the complete project was properly built, otherwise run `npm install` once in the root of the Langium project. That is enough, since we use npm workspaces to manage all of our npm projects as one monorepo.
+* Run `npm run build` (again in the root directly) to actually generate the JavaScript code from the TypeScript sources.
+* Use `node ./bin/cli` from the arithmetics directory to run the cli. Follow the instructions or use `node ./bin/cli eval <full-path-to-calc-file>`, e.g.
+
+```bash
+cd examples/arithmetics
+node ./bin/cli eval example/example.calc
+```
+
+produces this result:
+
+```
+line 14: 2 * c ===> 16
+line 15: b % 2 ===> 1
+line 18: Root(D, 3) ===> 4.999999999999999
+line 19: Root(64, 3) ===> 3.9999999999999996
+line 20: Sqrt(81) ===> 9
+```
 
 The interpreter calculates each Evaluation in the source file and prints the result.
 
@@ -17,4 +33,4 @@ You also can use `arithmetics-cli` as a replacement for `node ./bin/cli`, if you
 ## VSCode Extension
 
 Please use the VSCode run configuration "Run Arithmetics Extension" to launch a new VSCode instance including the extension for this language.
-Use the run configuration "Attach" to attach the debugger.
+Afterwards, use the run configuration "Attach" to attach the debugger to the running language server.

examples/domainmodel/README.md

@@ -4,8 +4,20 @@
 
 The Domain Model Example features a generator that you can run via cli.
 
-* Ensure the complete project was properly built, otherwise run `npm install` from the root of the Langium project.
-* Use `node ./bin/cli` from the domainmodel directory to run the cli. Follow the instructions or use `node ./bin/cli generate <full-path-to-dmodel-file>`.
+* Ensure the complete project was properly built, otherwise run `npm install` once in the root of the Langium project. That is enough, since we use npm workspaces to manage all of our npm projects as one monorepo.
+* Run `npm run build` (again in the root directly) to actually generate the JavaScript code from the TypeScript sources.
+* Use `node ./bin/cli` from the domainmodel directory to run the cli. Follow the instructions or use `node ./bin/cli generate <full-path-to-dmodel-file>`, e.g.
+
+```bash
+cd examples/domainmodel
+node ./bin/cli generate example/blog.dmodel
+```
+
+produces this result:
+
+```
+Java classes generated successfully: generated/blog
+```
 
 The generator produces a Java class for each Entity and setter-getter methods for each Feature.
 
@@ -16,4 +28,4 @@ You also can use `domainmodel-cli` as a replacement for `node ./bin/cli`, if you
 ## VSCode Extension
 
 Please use the VSCode run configuration "Run Domainmodel Extension" to launch a new VSCode instance including the extension for this language.
-Use the run configuration "Attach" to attach the debugger.
+Afterwards, use the run configuration "Attach" to attach the debugger to the running language server.

examples/requirements/README.md

@@ -49,8 +49,20 @@ CLI and tests:
 
 The Example features a generator that you can run via cli to process Requirement Model files. The outcome is a HTML table with a coverage matrix indicating which Test Cases test the Requirements of the file passed to the CLI.
 
-* Ensure the complete project was properly built, otherwise run `npm install` from the root of the Langium project.
-* Use `node ./bin/cli` from the requirements directory to run the cli. Follow the instructions or use `node ./bin/cli generate <full-path-to-req-file>`.
+* Ensure the complete project was properly built, otherwise run `npm install` once in the root of the Langium project. That is enough, since we use npm workspaces to manage all of our npm projects as one monorepo.
+* Run `npm run build` (again in the root directly) to actually generate the JavaScript code from the TypeScript sources.
+* Use `node ./bin/cli` from the requirements directory to run the cli. Follow the instructions or use `node ./bin/cli generate <full-path-to-req-file>`, e.g.
+
+```bash
+cd examples/requirements
+node ./bin/cli generate example/requirements.req
+```
+
+produces this result:
+
+```
+Requirement coverage generated successfully: generated/requirements.html
+```
 
 The generator produces an HTML file.
 
@@ -62,7 +74,7 @@ You also can use `requirements-and-tests-lang-cli` as a replacement for `node ./
 ## VSCode Extension
 
 Please use the VSCode run configuration "Run Requirements and Tests Extension" to launch a new VSCode instance including the extension for this language.
-Use the run configuration "Attach" to attach the debugger.
+Afterwards, use the run configuration "Attach" to attach the debugger to the running language server.
 
 ## Validators
 

examples/statemachine/README.md

@@ -4,8 +4,20 @@
 
 The State Machine Example features a generator that you can run via cli.
 
-* Ensure the complete project was properly built, otherwise run `npm install` from the root of the Langium project.
-* Use `node ./bin/cli` from the statemachine directory to run the cli. Follow the instructions or use `node ./bin/cli generate <full-path-to-statemachine-file>`.
+* Ensure the complete project was properly built, otherwise run `npm install` once in the root of the Langium project. That is enough, since we use npm workspaces to manage all of our npm projects as one monorepo.
+* Run `npm run build` (again in the root directly) to actually generate the JavaScript code from the TypeScript sources.
+* Use `node ./bin/cli` from the statemachine directory to run the cli. Follow the instructions or use `node ./bin/cli generate <full-path-to-statemachine-file>`, e.g.
+
+```bash
+cd examples/statemachine
+node ./bin/cli generate example/trafficlight.statemachine
+```
+
+produces this result:
+
+```
+C++ code generated successfully: generated/trafficlight.cpp
+```
 
 The generator produces a C++ cli to walk over the statemachine's states.
 
@@ -20,4 +32,4 @@ You also can use `statemachine-cli` as a replacement for `node ./bin/cli`, if yo
 ## VSCode Extension
 
 Please use the VSCode run configuration "Run Statemachine Extension" to launch a new VSCode instance including the extension for this language.
-Use the run configuration "Attach" to attach the debugger.
+Afterwards, use the run configuration "Attach" to attach the debugger to the running language server.