search

OpenLiberty / guide-getting-started

An introductory guide to writing and deploying applications on Open Liberty using Maven and Docker: https://openliberty.io/guides/getting-started.html
Other
15 stars 55 forks source link

guide is not useful at all #192

Closed nezarat closed 1 year ago

nezarat commented 4 years ago

it is not a getting start project! it is a demo! in the getting start project you step by step tell the developer what to do to build this sample project, not just ask him to run and test it...

salmad3 commented 4 years ago

Hi @nezarat. Thank you for raising your concern.

The Getting started with Open Liberty is an introductory-level guide to introduce Open Liberty to the developer. The guide aims to provide the developer with initial exposure in using the Open Liberty server by developing a Java application on Open Liberty with Maven and Docker. The goals of the guide are reflective in the What you'll learn section. These goals are:

Keep in mind, offering a guide in a way that builds an application from scratch needs to be presented in a realistic time frame. The content in the guide also needs to focus on the general scope of the Open Liberty guides: using the Open Liberty server for cloud-native development. All of the Open Liberty guides touch base on the key/major components of their applications to maintain this scope.

The application in the Getting Started with Open Liberty guide could have been any arbitrary Java web application using Java EE or Eclipse MicroProfile API's that runs on the Open Liberty server, though, this guide uses a simple REST application because the purpose of this introductory guide is to teach the developer how to use Open Liberty. As a result, I would argue that the Getting Started with Open Liberty guide is a step-by-step project.

To put it into perspective, if I am a developer with a cloud-native application wanting to deploy my application, or have you what, the Getting Started with Open Liberty guide teaches me that: 

(taken from the guide)
Open Liberty is an application server designed for the cloud. It’s small, lightweight, and designed with modern cloud-native
application development in mind. It supports the full MicroProfile and Java EE APIs and is composable, meaning that you can
use only the features that you need, keeping the server lightweight, which is great for microservices. It also deploys to every
major cloud platform, including Docker, Kubernetes, and Cloud Foundry.

Going through the guide, I will learn how to use the Open Liberty server, its configuration and some key features. I will also find out about the robust development mode feature where I can make changes to my application without needing to restart the server. As a developer, this is very useful. Eventually, I may intend to run my application in a docker container and I find out that this is easily achievable when using the Open Liberty server through the Running the application in a Docker container section.

If you would like to learn more about the technologies, please see the following:

Maven

If there is any specific feedback you can provide that would be appreciated.

yeekangc commented 4 years ago

Yes, appreciate your feedback, @nezarat.

Do you mind to elaborate on the parts that weren't useful from your perspective and how we may improve things? Thank you.

Are you looking for something that helps you create a starter project?

Cc @lauracowen @gkwan-ibm

gkwan-ibm commented 1 year ago

hi @nezarat, we are closing this issue because we didn't hear your reply for the questions in above. You may reopen this issue. It is appreciated if you can elaborate more to us how/what to improve. Or you may try out this Liberty deep dive tutorial.