Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation - would be good to have some schema explaining HelloWorld #1712

Open
agolubev opened this issue Jan 14, 2019 · 5 comments
Open

Comments

@agolubev
Copy link

HelloWorld seems to be the simplest application. However, on Lagom it's still a lot of moving parts so this may be confusing for newbie. I attached schema that supposes to give a general understanding on minimal Lagom application as well as processes inside.
helloworldlagom 4

Let me know if this makes sense.

@ihostage
Copy link
Contributor

HelloWorld seems to be the simplest application. However, on Lagom it's still a lot of moving parts so this may be confusing for newbie.

You right, HelloWorld is very complex for a newbie 😉

@agolubev
Copy link
Author

agolubev commented Jan 14, 2019

Well, it's not a rocket science - but it's definitely not obvious (at least from first glance) :)
Actually showing hello world in cluster mode would be more interesting

@WadeWaldron
Copy link
Contributor

Not to be negative, but it seems to me that any Hello World that requires an architecture diagram has failed to be a Hello World.

If I Googled "Lagom Hello World" and the first thing I saw was this diagram, I would probably move on to a different technology.

The problem here is that the Lagom "Hello World" isn't actually a Hello World. A typical Hello World application simply prints text to a screen, or a web page or whatever. This is writing data to database, it's doing streaming, it's putting messages on a Kafka topic. This is many steps beyond what a Hello World should be. A true Lagom Hello World would only demonstrate how to use the Service API to return the string "Hello World".

@agolubev
Copy link
Author

Well, Lagom has Chirper and Online Auction - they are fully functioning examples.
So my understanding is that we'll need to simplify hello world and create schemas for thoseChripher and auction applications. But I guess need input from Lafom team at this point

@agolubev
Copy link
Author

My point is that with a simple image it's so much easier to understand main moving parts.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

No branches or pull requests

4 participants