From 70a2eccde913324488cc726507ecc5d881338225 Mon Sep 17 00:00:00 2001 From: Steffen Waldmann Date: Mon, 9 Oct 2023 14:12:20 +0200 Subject: [PATCH 1/2] New ordered list style for Getting Started guide --- java/getting-started.md | 35 ++++++++++++++++++++++++++++++++--- 1 file changed, 32 insertions(+), 3 deletions(-) diff --git a/java/getting-started.md b/java/getting-started.md index 98e5f7298..af1522aef 100644 --- a/java/getting-started.md +++ b/java/getting-started.md @@ -5,14 +5,43 @@ synopsis: > redirect_from: java/overview status: released --- - # Getting Started - {{ $frontmatter.synopsis }} @@ -43,7 +72,7 @@ Excited? The following sections describe how to set up a development environment This section describes the prerequisites and tools to build a CAP application locally. -1. Install the CDS tools (`cds-dk)` by following the steps in section *[Getting Started > Local Set Up](../get-started/jumpstart#setup)*. +1. Install the CDS tools (`cds-dk`) by following the steps in section *[Getting Started > Local Set Up](../get-started/jumpstart#setup)*. 2. Install a Java VM. At least, Java 17 is required. For example, [download](https://github.com/SAP/SapMachine/releases/latest) and [install](https://github.com/SAP/SapMachine/wiki/Installation) SapMachine 17. From 12d7e6b19a9ccbfc39a2193e6cc57ad11b42f680 Mon Sep 17 00:00:00 2001 From: Steffen Waldmann Date: Mon, 9 Oct 2023 14:19:31 +0200 Subject: [PATCH 2/2] New ordered list styling for getting started --- get-started/in-a-nutshell.md | 99 ++++++++++++++++++++++++------------ java/getting-started.md | 33 +----------- 2 files changed, 68 insertions(+), 64 deletions(-) diff --git a/get-started/in-a-nutshell.md b/get-started/in-a-nutshell.md index f84a86739..bd1364ff8 100644 --- a/get-started/in-a-nutshell.md +++ b/get-started/in-a-nutshell.md @@ -8,6 +8,39 @@ uacp: This page is linked from the Help Portal at https://help.sap.com/products/ impl-variants: true --- + + # Getting Started in a Nutshell Using a minimal setup @@ -52,59 +85,59 @@ git clone https://github.com/sap-samples/cloud-cap-samples-java bookshop 1. Create a new project using `cds init` -::: code-group -```sh [Node.js] -cds init bookshop -``` -```sh [Java] -cds init bookshop --add java -``` -::: + ::: code-group + ```sh [Node.js] + cds init bookshop + ``` + ```sh [Java] + cds init bookshop --add java + ``` + ::: 2. Open the project in VS Code -```sh -code bookshop -``` + ```sh + code bookshop + ``` -::: details **Note:** VS Code CLI on macOS needs extra setup + ::: details **Note:** VS Code CLI on macOS needs extra setup -Users on macOS must first run a command (*Shell Command: Install 'code' command in PATH*) to add the VS Code executable to the `PATH` environment variable. Read VS Code's [macOS setup guide](https://code.visualstudio.com/docs/setup/mac) for help. + Users on macOS must first run a command (*Shell Command: Install 'code' command in PATH*) to add the VS Code executable to the `PATH` environment variable. Read VS Code's [macOS setup guide](https://code.visualstudio.com/docs/setup/mac) for help. -::: + ::: 3. Run `cds watch` in an [*Integrated Terminal*](https://code.visualstudio.com/docs/terminal/basics) -::: code-group + ::: code-group -```sh [Node.js] -cds watch -``` + ```sh [Node.js] + cds watch + ``` -```sh [Java] -cd srv && mvn cds:watch -``` + ```sh [Java] + cd srv && mvn cds:watch + ``` -::: + ::: -::: details `cds watch` is waiting for things to come... + ::: details `cds watch` is waiting for things to come... -```log -[dev] cds w + ```log + [dev] cds w -cds serve all --with-mocks --in-memory? -live reload enabled for browsers + cds serve all --with-mocks --in-memory? + live reload enabled for browsers - ___________________________ + ___________________________ - No models found in db/,srv/,app/,schema,services. // [!code focus] - Waiting for some to arrive... // [!code focus] + No models found in db/,srv/,app/,schema,services. // [!code focus] + Waiting for some to arrive... // [!code focus] -``` + ``` -So, let's go on adding some CDS model as follows... + So, let's go on adding some CDS model as follows... -::: + ::: diff --git a/java/getting-started.md b/java/getting-started.md index af1522aef..0a4e1d755 100644 --- a/java/getting-started.md +++ b/java/getting-started.md @@ -5,43 +5,14 @@ synopsis: > redirect_from: java/overview status: released --- + # Getting Started - {{ $frontmatter.synopsis }}