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

Refresh Qute guides with the new Qute Web flow #37097

Open
ia3andy opened this issue Nov 15, 2023 · 3 comments
Open

Refresh Qute guides with the new Qute Web flow #37097

ia3andy opened this issue Nov 15, 2023 · 3 comments
Labels
area/qute The template engine kind/enhancement New feature or request

Comments

@ia3andy
Copy link
Contributor

ia3andy commented Nov 15, 2023

Description

Currently there are 3 guides for Qute:

The idea is to bring it to two guides that gives the same story to users:

  • Qute Web is the tutorial guide where you learn how to start from a basic 2-3 page website (without using REST) evolving a more sophisticated solution using a Qute REST endpoints (always pointing to qute-reference for full reference)
  • Qute Reference is the reference guide:
    • The Simplest Example
    • Qute Core features
    • Qute Web to bring it to the Web and do SSR
    • Qute Web + REST to bind templates on REST endpoints

On both the tutorial and the reference we should have a small section about:

  • Web Bundler to bundle javascript & styles alongside Qute
  • Renarde to use Qute in a MVC fashion

The Qute Web Quarkiverse guide should redirect to the quarkus.io one.

@ia3andy ia3andy added the kind/enhancement New feature or request label Nov 15, 2023
@quarkus-bot quarkus-bot bot added the area/qute The template engine label Nov 15, 2023
Copy link

quarkus-bot bot commented Nov 15, 2023

/cc @mkouba (qute)

@ia3andy
Copy link
Contributor Author

ia3andy commented Nov 15, 2023

@maxandersen I think it would also make sense to have a Quarkus Web quarkus.io/web guide for posterity that explain the Quarkus Web story and with links to the docs:

  • Qute Web for SSR
  • Renarde for SSR with MVC
  • Web Bundler / mvnpm to bundle assets and npm dependencies (js, ts, css, scss)
  • Quarkus + HTMX
  • Quinoa for NodeJS SPA seamless integration (if you need npm features which are not available in the Web Bundler)

Then in the blog Quarkus Fullstack/Web Rainbow post, I would quote/link it and write it as an article.

@ia3andy
Copy link
Contributor Author

ia3andy commented Nov 15, 2023

cc @FroMage

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/qute The template engine kind/enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

1 participant