Skip to content

Commit 98c8fca

Browse files
Merge branch 'main' into api-first-tutorial
2 parents 5e9df32 + 88f93ef commit 98c8fca

File tree

19 files changed

+123
-146
lines changed

19 files changed

+123
-146
lines changed

.github/workflows/buildMain.yml

+3
Original file line numberDiff line numberDiff line change
@@ -59,6 +59,9 @@ jobs:
5959
run: npm install
6060

6161
- name: run buildRun.sh ${{ github.event.inputs.logLevel }}
62+
env:
63+
# remove maven download logs as it might cause random build failures: https://stackoverflow.com/a/66801171
64+
MAVEN_ARGS: "-Djansi.force=true -Djansi.passthrough=true -B -Dorg.slf4j.simpleLogger.log.org.apache.maven.cli.transfer.Slf4jMavenTransferListener=warn"
6265
run: sh buildRun.sh -p ${{ matrix.tutorial }} ${{ github.event.inputs.logLevel }}
6366

6467
- name: Multiple Repositories Dispatcher

JumpTheQueue/index.asciidoc

+8
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,12 @@
11
= Jump start an end-to-end devonfw sample application.
2+
3+
[tags]
4+
--
5+
technology=Java;devon4j;devon4ng
6+
difficulty=beginner
7+
topic=Jump The Queue;end-to-end;e2e
8+
--
9+
210
====
311
Jump The Queue is a small application based on the devonfw framework, which you can create yourself by following our simple step-by-step tutorial. By doing so, you will learn about the app development workflow and gain insight into the design of a professional business information system.
412

README.adoc

+1-1
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Welcome to the devonfw repository for all devonfw assets. You can find all ready
44

55
== How to Create Your Tutorial
66

7-
Get to know how to write your first tutorial by running your first https://katacoda.com/devonfw/scenarios/tutorial-compiler[katacoda tutorial] on this topic! Additionally, You can find an detailed explanation as well in the wiki https://github.com/devonfw-tutorials/tutorials/wiki/Development[here].
7+
Get to know how to write your first tutorial by running your first https://katacoda.com/devonfw/scenarios/tutorial-compiler[katacoda tutorial] on this topic! Additionally, You can find a detailed explanation as well in the wiki https://github.com/devonfw-tutorials/tutorials/wiki/Development[here].
88

99
An overview of the commands available for tutorial specification out of the box can be found in the https://github.com/devonfw-tutorials/tutorials/wiki/Functions[function reference].
1010

angular-mock-service/index.asciidoc

+8
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,12 @@
11
= Angular Data Mocking and Service: A way to test the untestables
2+
3+
[tags]
4+
--
5+
technology=Angular;devon4ng
6+
difficulty=beginner
7+
topic=testing;mock;unit test;service
8+
--
9+
210
====
311
In this scenario, you will learn how to write a simple mock service that helps us by feeding data into our components.
412

cobigen-setup/index.asciidoc

+8
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,12 @@
11
= Setting up devonfw Code Generator(i.e. CobiGen)
2+
3+
[tags]
4+
--
5+
technology=CobiGen;Java;CobiGen CLI;Eclipse;devonfw
6+
difficulty=beginner
7+
topic=setup
8+
--
9+
210
====
311
CobiGen is a generic incremental code generator. It allows you to generate application code based on the devonfw architecture including all software layers.
412
There is also a CobiGen Command Line Interface(CLI) where you can start the setup following the generation of code.

cobigen/files/CustomerEntity.java

-60
This file was deleted.

cobigen/files/Placeholder.java

-9
This file was deleted.

cobigen/index.asciidoc

-76
This file was deleted.

create-your-own-tutorial/index.asciidoc

+8
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,12 @@
11
= Create your own tutorial
2+
3+
[tags]
4+
--
5+
technology=asciidoc;Katacoda;wiki;tutorial-compiler
6+
difficulty=beginner
7+
topic=tutorial;documentation
8+
--
9+
210
====
311
In this scenario, you will learn how to create your own tutorial using the tutorial compiler.
412

devon4j-app/index.asciidoc

+9
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,13 @@
11
= Generate your Java application with devon4j
2+
3+
[tags]
4+
--
5+
technology=Java;devonfw;Maven
6+
difficulty=beginner
7+
topic=project generation;setup;architecture;first application
8+
asset=devon4j;My Thay Star
9+
--
10+
211
====
312
devon4j is the Java stack of devonfw. It allows you to build business applications (backends) using Java technology in a highly efficient and standardized way based on established best-practices.
413

devon4j-architecture/index.asciidoc

+9
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,13 @@
11
= devon4j architecture in practice
2+
3+
[tags]
4+
--
5+
technology=Java
6+
difficulty=beginner
7+
topic=architecture
8+
asset=devon4j
9+
--
10+
211
====
312
## Prerequisites
413

devon4j-http-rest-client/index.asciidoc

+8
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,12 @@
11
= Develop a devon4j CXF REST Client using Synchronous call
2+
3+
[tags]
4+
--
5+
technology=Java;HTTP;Spring Data;Spring JPA;Flyway;Apache CXF;JAX-RS
6+
difficulty=intermediate
7+
topic=Rest;Rest API;authentication;API;client
8+
asset=devon4j;My Thai Star
9+
--
210
====
311
REST (REpresentational State Transfer) is an inter-operable protocol for services that is more lightweight than SOAP. We give best practices that lead to simple, easy and pragmatic "HTTP APIs".
412

devon4j-migrate/index.asciidoc

+9
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,13 @@
11
= Migrate a devon4j project to the latest version
2+
3+
[tags]
4+
--
5+
technology=Java;devonfw
6+
difficulty=beginner
7+
topic=migration;version
8+
asset=devon4j
9+
--
10+
211
====
312
This tutorial mainly focuses on migrating an older version of devon4j project to the latest version using devon4j migrate command.
413

devon4ng-architecture/index.asciidoc

+9
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,14 @@
11
= devon4ng architecture
22
== Understand the architecture principles followed by devon4ng (the angular asset of devonfw)
3+
4+
[tags]
5+
--
6+
technology=Angular
7+
difficulty=beginner
8+
topic=architecture;module
9+
asset=devon4ng
10+
--
11+
312
====
413
## Prerequisites
514

devon4ng-lazy-loading/index.asciidoc

+9
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,14 @@
11
= Boost Angular’s Performance by Lazy Loading your Modules with devon4ng
22
== Learn how to defer initialization of modules in Angular until it is needed
3+
4+
[tags]
5+
--
6+
technology=Angular
7+
difficulty=intermediate
8+
topic=architecture;lazy loading;module;design pattern
9+
asset=devon4ng;My Thai Star
10+
--
11+
312
====
413
In single-page-applications as the application size increases its loading speed decreases (since typically the entire application is loaded at once). Lazy loading is a design pattern that defers initialization of objects until it is needed. Angular handles lazy loading through the routing module which redirects to requested pages. Those pages can be loaded at start or on demand. In this tutorial you will build a simple app to understand how lazyloading is implemented in Angular.
514

devon4ng-mat-layout/index.asciidoc

+9
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,13 @@
11
= Create an Angular application with Angular Material components using devon4ng
2+
3+
[tags]
4+
--
5+
technology=Angular;Angular Material;CSS;HTML
6+
difficulty=beginner
7+
topic=style;UI component library;component;animation;layout
8+
asset=devon4j
9+
--
10+
211
====
312
The purpose of this tutorial is to get a basic understanding of creating layouts using Angular Material in a devon4ng application. You will create an application with a header containing some menu links and a sidenav with some navigation links.
413

devonfw-ide/index.asciidoc

+8
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,12 @@
11
= Bootstrap your devonfw development environment
2+
3+
[tags]
4+
--
5+
technology=devonfw;devon
6+
difficulty=beginner
7+
topic=setup;IDE;installation
8+
--
9+
210
====
311
devonfw offers complete IDE solution integrated with a lot​ of integrated tooling and initial settings​.
412
It massively speeds up development, reduces risks and helps deliver better results.

openapi-generation-servicedocgen/index.asciidoc

+9
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,13 @@
11
= OpenAPI and Swagger UI generation with ServicedocGen plugin
2+
3+
[tags]
4+
--
5+
technology=Java;ServicedocGen;OpenAPI;Maven;QuarkusIO;Quarkus;Swagger;Swagger UI;quarkus-quickstarts
6+
difficulty=intermediate
7+
topic=plugin;documentation
8+
asset=devon4j
9+
--
10+
211
====
312
This tutorial will teach you how to use the [ServicedocGen maven plugin](http://www.mojohaus.org/servicedocgen-maven-plugin/) to generate the OpenAPI specification and Swagger UI from your REST APIs.
413

openapi-generation-smallrye/index.asciidoc

+8
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,12 @@
11
= OpenAPI and Swagger UI generation with Quarkus Smallrye extension
2+
3+
[tags]
4+
--
5+
technology=Java;OpenAPI;Maven;QuarkusIO;Quarkus;SmallRye;Swagger;Swagger UI;quarkus-quickstarts
6+
difficulty=intermediate
7+
topic=plugin;documentation
8+
asset=devon4j
9+
--
210
====
311
This tutorial will show you how to include the Quarkus Smallrye OpenAPI extension in Quarkus projects to automatically generate OpenAPI specifications and Swagger UI from your REST APIs.
412
For more information about OpenAPI and the Smallrye OpenAPI extension, see the [devon4j documentation](https://github.com/devonfw/devon4j/blob/master/documentation/guide-openapi.asciidoc) or the [official Quarkus guide](https://quarkus.io/guides/openapi-swaggerui).

0 commit comments

Comments
 (0)