Merge branch 'master' of https://github.com/sap-tutorials/Tutorials

Author: qmacro

tutorials/abap-environment-behavior-definition/abap-environment-behavior-definition.md

@@ -58,7 +58,7 @@ In this tutorial, wherever `XXX` appears, use a number (e.g. `000`).
         delete;
 
         field (mandatory) id;
-        field (read only) lastchangedbyuser, lastchangeddatetime;
+        field (readonly) lastchangedbyuser, lastchangeddatetime;
       }
     ```
    Save and activate.

tutorials/btp-app-cap-mta-deployment/btp-app-cap-mta-deployment.md

@@ -70,7 +70,6 @@ The deployment is based on MTA ( *Multi-Target Application*, sometimes also call
 [ACCORDION-BEGIN [Step 2: ]((For Windows) Install make tool)]
 > ### To earn your badge for the whole mission, you will need to mark all steps in a tutorial as done, including any optional ones that you may have skipped because they are not relevant for you.
 
-
 The `make` tool is required by the `mbt` tool. Linux and macOS are already shipped with `make`. For Windows you can download it from the GNU Make site:
 
 1. Go to <http://gnuwin32.sourceforge.net/packages/make.htm>.
@@ -395,4 +394,4 @@ The result of this tutorial can be found in the [`cap-mta-deployment`](https://g
 
 
 [ACCORDION-END]
----
+---

tutorials/btp-app-ci-cd-btp/btp-app-ci-cd-btp.md

@@ -25,6 +25,8 @@ primary_tag: software-product-function>sap-cloud-application-programming-model
 ---
 
 [ACCORDION-BEGIN [Step 1: ](Introduction)]
+> ### To earn your badge for the whole mission, you will need to mark all steps in a tutorial as done, including any optional ones that you may have skipped because they are not relevant for you.
+
 [SAP Continuous Integration and Delivery (CI/CD)](https://help.sap.com/viewer/product/CONTINUOUS_DELIVERY/Cloud/en-US) is a service on SAP BTP, which lets you configure and run predefined continuous integration and delivery pipelines. It connects with your Git SCM repository and builds, tests, and deploys your code changes. In its user interface, you can easily monitor the status of your builds and detect errors as soon as possible, which helps you prevent integration problems before completing your development.
 
 SAP Continuous Integration and Delivery has a ready-to-use pipeline for CAP, that is applicable to multi-target application (MTA) and Node.js based projects. It does not require you to host your own Jenkins instance and it provides an easy, UI-guided way to configure your pipelines.
@@ -178,7 +180,7 @@ If your GitHub repository is not private, you can skip this section. If your Git
 
 1. Navigate to the **Credentials** tab in SAP Continuous Integration and Delivery.
 
-2. Choose **+** to create credentials.
+2. Choose ( + ) to create credentials.
 
     !![Credentials](CICD_credentials.png)
 
@@ -218,7 +220,7 @@ If your GitHub repository is not private, you can skip this section. If your Git
 [ACCORDION-END]
 ---
 [ACCORDION-BEGIN [Step 6: ](Configure a CI/CD job)]
-1. In the **Jobs** tab in SAP Continuous Integration and Delivery, choose **+** to create a new job.
+1. In the **Jobs** tab in SAP Continuous Integration and Delivery, choose ( + ) to create a new job.
 
     !![Jobs](CICD_jobs.png)
 

tutorials/btp-app-create-directory/btp-app-create-directory.md

@@ -117,7 +117,7 @@ If you don't want to start from scratch, but from a specific example of the tuto
 
 4. Check out the example's branch.
 
-    ``` bash
+    ```Shell/Bash
     cd tutorial
     git checkout <branch>
     ```

tutorials/btp-app-events-app-setup-s4hc/btp-app-events-app-setup-s4hc.md

@@ -9,6 +9,8 @@ time: 40
 tags: [tutorial>intermediate, tutorial>license, software-product-function>sap-cloud-application-programming-model, programming-tool>node-js, software-product>sap-business-technology-platform, software-product>sap-api-management, software-product>sap-hana-cloud, software-product>sap-s-4hana-cloud]
 primary_tag: software-product-function>sap-cloud-application-programming-model
 ---
+
+
 ## Prerequisites
  - [Add the Consumption of an External Service to Your CAP Application](btp-app-ext-service-add-consumption)
  - [Consume the External Service in the UI of Your Application](btp-app-ext-service-consume-ui)
@@ -26,14 +28,21 @@ primary_tag: software-product-function>sap-cloud-application-programming-model
     - You must be an administrator of the SAP S/4HANA Cloud system.
     - You need to connect this system to your SAP BTP global account, if you'd like to build extension applications for your SAP S/4HANA Cloud system.
 
+
 ## Details
 ### You will learn
  - How to configure your CAP application for eventing
  - How to locally test your changes
  - How to deploy your CAP application
+
+
+To start with this tutorial use the result in the [`ext-service-s4hc-use`](https://github.com/SAP-samples/cloud-cap-risk-management/tree/ext-service-s4hc-use) branch.
+
 ---
 
 [ACCORDION-BEGIN [Step 1: ](Configure your CAP application for eventing)]
+> ### To earn your badge for the whole mission, you will need to mark all steps in a tutorial as done, including any optional ones that you may have skipped because they are not relevant for you.
+
 CAP provides native support for emitting and receiving events. Hence, CAP applications can receive events for changes in remote systems. In CAP, the messaging follows a publish subscribe (pub/sub) model. Pub/sub means that sources publish messages and interested consumers can subscribe to receive them. This helps with scalability, decoupling of services, and robustness.
 
 Using the Business Partner service that you added in `Step 1: Get the Business Partner service definition` from the tutorial [Add the Consumption of an External Service to Your CAP Application](btp-app-ext-service-add-consumption), you will configure the CAP application to listen and react to events from your SAP S/4HANA Cloud system. As in the previous tutorials, let's again use the example of business partners that are suppliers. So, you will use suppliers when referring to business partners. First you will add event definitions for the SAP S/4HANA events.
@@ -246,7 +255,7 @@ Currently, business partner (that is, supplier) data is stored only in the SAP S
 [ACCORDION-END]
 ---
 [ACCORDION-BEGIN [Step 3: ](Test your changes locally)]
-So, you have added logic to create a new risk when an event for a newly created supplier is received.You have also added logic to update our risks when an event for an updated supplier is received from our SAP HANA Cloud system. This is achieved by listening to events from the SAP S/4HANA Cloud system.
+So, you have added logic to create a new risk when an event for a newly created supplier is received. You have also added logic to update our risks when an event for an updated supplier is received from our SAP HANA Cloud system. This is achieved by listening to events from the SAP S/4HANA Cloud system.
 
 Now simulate locally business partner creation and update, and see the results:
 

tutorials/btp-app-events-s4hc-use/btp-app-events-s4hc-use.md

@@ -9,6 +9,7 @@ time: 30
 tags: [tutorial>intermediate, tutorial>license, software-product-function>sap-cloud-application-programming-model, programming-tool>node-js, software-product>sap-business-technology-platform, software-product>sap-api-management, software-product>sap-hana-cloud, software-product>sap-s-4hana-cloud]
 primary_tag: software-product-function>sap-cloud-application-programming-model
 ---
+
 ## Prerequisites
  - [Add the Consumption of an External Service to Your CAP Application](btp-app-ext-service-add-consumption)
  - [Consume the External Service in the UI of Your Application](btp-app-ext-service-consume-ui)
@@ -32,6 +33,7 @@ primary_tag: software-product-function>sap-cloud-application-programming-model
 ### You will learn
  - How to create and change a Business Partner in your SAP S/4HANA Cloud system
  - How to check if the Business Partner creation and change events sent from your SAP S/4HANA Cloud system have updated your CAP application
+
 ---
 
 [ACCORDION-BEGIN [Step 1: ](Create a Business Partner and check updates in your CAP application)]
@@ -67,9 +69,9 @@ Congratulations! You have completed all tutorials.
 
 [VALIDATE_1]
 
+
 <p style="text-align: center;">Give us 55 seconds of your time to help us improve.</p>
 
 <p style="text-align: center;"><a href="https://sapinsights.eu.qualtrics.com/jfe/form/SV_0im30RgTkbEEHMV?TutorialID=btp-app-events-s4hc-use" target="_blank"><img src="https://raw.githubusercontent.com/SAPDocuments/Tutorials/master/data/images/285738_Emotion_Faces_R_purple.png"></a></p>
-<!--TAIL END-->
 [ACCORDION-END]
 ---

tutorials/btp-app-ext-service-add-consumption/btp-app-ext-service-add-consumption.md

@@ -205,7 +205,7 @@ Later in the tutorial [Use SAP S/4HANA Cloud Service](btp-app-ext-service-s4hc-u
 
 4. Run `cds watch` with the sandbox profile:
 
-    ```
+    ```Shell/Bash
     cds watch --profile sandbox
     ```
 
@@ -258,7 +258,7 @@ To solve this issue, you add some handler code to delegate the call from the `Su
 
 2. Run `cds watch` with the sandbox profile:
 
-    ```
+    ```Shell/Bash
     cds watch --profile sandbox
     ```
 
@@ -329,7 +329,7 @@ This code is required for the sandbox only. The authentication for SAP S/4HANA s
 
 6. Run `cds watch` with the sandbox profile:
 
-    ```
+    ```Shell/Bash
     cds watch --profile sandbox
     ```
 

tutorials/btp-app-ext-service-consume-ui/btp-app-ext-service-consume-ui.md

@@ -48,7 +48,7 @@ To start with this tutorial use the result in the [`ext-service-add-consumption`
 
 3. Run `cds watch` with the sandbox profile:
 
-    ```
+    ```Shell/Bash
     cds watch --profile sandbox
     ```
 
@@ -194,7 +194,7 @@ Next, you add the name of the supplier and the blocked status to the `Risks` UI.
 
 5. Run `cds watch` with the sandbox profile:
 
-    ```
+    ```Shell/Bash
     cds watch --profile sandbox
     ```
 
@@ -254,7 +254,7 @@ The last thing you add is the value help to select a supplier from the remote sy
 
 3. Run `cds watch` with the sandbox profile:
 
-    ```
+    ```Shell/Bash
     cds watch --profile sandbox
     ```
 

tutorials/btp-app-ext-service-s4hana-consume/btp-app-ext-service-s4hana-consume.md

@@ -225,14 +225,12 @@ When creating new entries in the **Risks** application, you should be able to us
 Congratulations! You have completed all tutorials.
 
 
-<p style="text-align: center;">Give us 55 seconds of your time to help us improve.</p>
-
-<p style="text-align: center;"><a href="https://sapinsights.eu.qualtrics.com/jfe/form/SV_0im30RgTkbEEHMV?TutorialID=btp-app-ext-service-s4hana-consume" target="_blank"><img src="https://raw.githubusercontent.com/SAPDocuments/Tutorials/master/data/images/285738_Emotion_Faces_R_purple.png"></a></p>
-<!--TAIL END-->
 
 [DONE]
 The result of this tutorial can be found in the [`ext-service-s4hana-consume`](https://github.com/SAP-samples/cloud-cap-risk-management/tree/ext-service-s4hana-consume) branch.
 
+<p style="text-align: center;">Give us 55 seconds of your time to help us improve.</p>
 
+<p style="text-align: center;"><a href="https://sapinsights.eu.qualtrics.com/jfe/form/SV_0im30RgTkbEEHMV?TutorialID=btp-app-ext-service-s4hana-consume" target="_blank"><img src="https://raw.githubusercontent.com/SAPDocuments/Tutorials/master/data/images/285738_Emotion_Faces_R_purple.png"></a></p>
 [ACCORDION-END]
 ---

tutorials/btp-app-ext-service-s4hc-use/btp-app-ext-service-s4hc-use.md

@@ -202,7 +202,7 @@ When creating new entries in the **Risks** application, you should be able to us
 
     You'll see a message `No data found. Try adjusting filter or search criteria.`
 
-    > In case you get an error `Forbidden`.
+    > In case you get an error `Forbidden`. 
 
     > The following error is displayed when you haven't assigned your user to the `RiskManager-<your space>` role:
 
@@ -232,12 +232,11 @@ Congratulations! You have completed all tutorials.
 
 [VALIDATE_1]
 
-<p style="text-align: center;">Give us 55 seconds of your time to help us improve.</p>
 
-<p style="text-align: center;"><a href="https://sapinsights.eu.qualtrics.com/jfe/form/SV_0im30RgTkbEEHMV?TutorialID=btp-app-ext-service-s4hc-use" target="_blank"><img src="https://raw.githubusercontent.com/SAPDocuments/Tutorials/master/data/images/285738_Emotion_Faces_R_purple.png"></a></p>
-<!--TAIL END-->
 The result of this tutorial can be found in the [`ext-service-s4hc-use`](https://github.com/SAP-samples/cloud-cap-risk-management/tree/ext-service-s4hc-use) branch.
 
+<p style="text-align: center;">Give us 55 seconds of your time to help us improve.</p>
 
+<p style="text-align: center;"><a href="https://sapinsights.eu.qualtrics.com/jfe/form/SV_0im30RgTkbEEHMV?TutorialID=btp-app-ext-service-s4hc-use" target="_blank"><img src="https://raw.githubusercontent.com/SAPDocuments/Tutorials/master/data/images/285738_Emotion_Faces_R_purple.png"></a></p>
 [ACCORDION-END]
----
+---

tutorials/btp-app-launchpad-service/btp-app-launchpad-service.md

@@ -334,7 +334,6 @@ The newly added modules `nsrisks` and `nsmitigations` do the build of the SAP Fi
         supported-platforms: []
     ```
 
-
 2. Check the `mitigations` application module `nsmitigations`:
 
     <!-- snippet mta.yaml --branch launchpad-service modules: "- name: nsmitigations" -->
@@ -433,13 +432,13 @@ app/*/package-lock.json
 
     !![Choose Subaccount](choose_subaccount.png)
 
-2. Choose **Services** **&rarr;** **Service Marketplace** on the left.
+4. Choose **Services** **&rarr;** **Service Marketplace** on the left.
 
-3. Search for the **Launchpad Service** tile and choose **Create**.
+5. Search for the **Launchpad Service** tile and choose **Create**.
 
     !![Create Launchpad Service](create_launchpad_service.png)
 
-4. Keep the default settings for **Service** and **Plan** and choose **Create**.
+6. Keep the default settings for **Service** and **Plan** and choose **Create**.
 
     !![New Instance or Subscription](new_instance_dialog.png)
 
@@ -455,11 +454,11 @@ You need to assign your user to the `Launchpad_Admin` role collection, so you do
 
 2. Choose your user.
 
-4. Under **Role Collections** on the right, choose **Assign Role Collection** and assign the `Launchpad_Admin` role collection to your user.
+3. Under **Role Collections** on the right, choose **Assign Role Collection** and assign the `Launchpad_Admin` role collection to your user.
 
     !![Add role](add_launchpad_admin_role.png)
 
-5. Open another browser or clear your browser's cache.
+4. Open another browser or clear your browser's cache.
 
 > See section [Initial Setup](https://help.sap.com/viewer/8c8e1958338140699bd4811b37b82ece/Cloud/en-US/fd79b232967545569d1ae4d8f691016b.html) in the SAP Launchpad service's documentation for more details.
 

tutorials/btp-app-logging/btp-app-logging.md

@@ -83,7 +83,7 @@ To start with this tutorial use the result in the [`launchpad-service`](https://
 [ACCORDION-END]
 ---
 [ACCORDION-BEGIN [Step 3: ](Analyze logs using Kibana dashboard)]
-1. In SAP BTP cockpit navigate to your **Subaccount**.
+1. In SAP BTP Cockpit, navigate to your **Subaccount**.
 
 2. Choose **Cloud Foundry** **→** **Spaces**.
 
@@ -206,9 +206,9 @@ In our experience, the `development` plan wasn't sufficient for test scenarios.
 [ACCORDION-END]
 ---
 [ACCORDION-BEGIN [Step 5: ](Test it)]
-1. Build the MTAR file and deploy it to your Cloud Foundry space.
+1. Build the MTAR file and deploy it to your Cloud Foundry space:
 
-    ```
+    ```Shell/Bash
     mbt build -t ./
     cf deploy cpapp_1.0.0.mtar
     ```
@@ -225,10 +225,11 @@ In our experience, the `development` plan wasn't sufficient for test scenarios.
 
     !![Kibana: Components](kibana_components.png)
 
-You can also browse all logs using the *Discover* button (compass icon) on the left navigation bar.
+You can also browse all logs using the **Discover** button (compass icon) on the left navigation bar.
 The available fields are displayed on the left side of the screen. You can add fields to the message display or quickly filter for any of the top values.
 
-The time filter is on the right top of the screen. Don't forget to choose *Refresh*.
+The time filter is on the right top of the screen. Don't forget to choose **Refresh**.
+
 
 
 [DONE]

tutorials/btp-app-prepare-btp/btp-app-prepare-btp.md

@@ -104,25 +104,25 @@ At least the services for the tutorials [Set Up the SAP HANA Cloud service](btp-
 [ACCORDION-BEGIN [Step 4: ](Create a subaccount)]
 1. Enter your **Global Account**. If you are using a trial account, choose **Go To Your Trial Account**.
 
-4. Choose **Account Explorer** in the left navigation pane.
+2. Choose **Account Explorer** in the left navigation pane.
 
-5. Choose **Create** **→** **Subaccount**.
+3. Choose **Create** **→** **Subaccount**.
 
     !![Create subaccount](create_subaccount.png)
 
-6. To fill the **New Subaccount** dialog, enter a **Display Name**.
+4. To fill the **New Subaccount** dialog, enter a **Display Name**.
 
     > Use a short name for your project and add the prefix for the landscape, for example: `<project name>-cf-us10`. Don't select the checkbox **Neo**!
 
-7. Enter a subdomain.
+5. Enter a subdomain.
 
     > Only valid HTTP domain characters are allowed.
 
-8. Choose **Create**.
+6. Choose **Create**.
 
-9. Wait for the completion of the subaccount creation.
+7. Wait for the completion of the subaccount creation.
 
-10. Choose the tile with your new subaccount.
+8. Choose the tile with your new subaccount.
 
 [DONE]
 [ACCORDION-END]
@@ -152,7 +152,7 @@ In this section, you assign a portion of the entitlements that you've bought for
 
 4. Go through the Entitlements according to the table in the previous step **Create a Live Account** and add the required plans for each of them.
 
-5. Choose the + or - symbol to change the quota for the services according to the table in the previous step **Create a Live Account**.
+5. Choose the ( &#x2B; ) or ( &#8209; ) symbol to change the quota for the services according to the table in the previous step **Create a Live Account**.
 
 6. Choose **Save**.
 
@@ -168,21 +168,23 @@ Next to Cloud Foundry orgs there are also [Spaces](https://docs.cloudfoundry.org
 
 3. Choose **Create Space**.
 
-4. Enter a space name (suggestion: If different sub projects exist in the org: `<sub project name>-<stage name>`, otherwise: `<stage name>`; where stage name is the release stage, for example: `dev`, `val`, `prod`)
+4. Enter a space name.
+
+    > If different sub projects exist in the org, use `<sub project name>-<stage name>`, otherwise use `<stage name>`; where stage name is the release stage, for example: `dev`, `val`, `prod`.
 
 5. Choose **Create**.
 
 [DONE]
 [ACCORDION-END]
 ---
 [ACCORDION-BEGIN [Step 8: ](Assign users in the Cloud Foundry space)]
-1. Open the **Spaces** overview in SAP BTP cockpit (you can just choose the tile for the space that was created).
+1. Open the **Spaces** overview in SAP BTP cockpit. You can just choose the tile for the space that was created.
 
 2. Choose **Members** in the left navigation pane.
 
 3. (Optional) Choose **Add Members** to add all required users, again your own user should already be part of the list.
 
-4. (Optional) Add a DL of your `CFDeployment` technical user as Space Manager if you have one.
+4. (Optional) Add a distribution list of your `CFDeployment` technical user as Space Manager if you have one.
 
 [DONE]
 [ACCORDION-END]

tutorials/btp-app-role-assignment/btp-app-role-assignment.md

@@ -79,7 +79,7 @@ Instead of creating the role collection automatically using the `xs-security.jso
 
 3. Choose **Security** **→** **Role Collections** on the left.
 
-4. Choose the **+** (new role collection) button.
+4. Choose the ( + ) icon to create a new role collection.
 
 5. Enter **Name** `RiskManager`.
 
@@ -109,4 +109,4 @@ The new role collection appears now in the list, but it doesn't contain any role
 
 [DONE]
 [ACCORDION-END]
----
+---

tutorials/btp-free-tier-account/btp-free-tier-account.md

@@ -10,7 +10,7 @@ primary_tag: software-product-function>sap-btp-cockpit
 ## Prerequisites
 - To activate your consumption-based SAP BTP global account with free tier service plans, you need a:
     - **Functioning e-mail address**
-    - **Credit card** for authentication and eventually later for billing purposes (if you do not own a credit card, create a Trial Account on SAP BTP as described in [Get a Free Account on SAP BTP Trial](hcp-create-trial-account)).
+    - **Credit card** for authentication and eventually later for billing purposes (if you do not own a credit card, you can create a trial account which allows you to try out BTP services in a separated environment but without the free tier model on SAP BTP: [Get a Free Account on SAP BTP Trial](hcp-create-trial-account)).
 
 
 ### How Does Free Tier Work?