In Qute guide, first Type-safe template example does not compile

[marc-bouvier]

Describe the bug

The first example about Type-safe template does not compile.
It throws a io.quarkus.qute.TemplateException that points the need for checked parameter.

Which pages

• https://quarkus.io/guides/qute#type-safe-templates

Stack Trace

Caused by: io.quarkus.qute.TemplateException: Found template problems (1):
[1] Incorrect expression found: {name}
        - Only type-safe expressions are allowed in the checked template defined via: org.acme.quarkus.sample.HelloResource $Templates.hello(); an expression must be based on a checked template parameter [], o
r bound via a param declaration, or the requirement must be relaxed via @CheckedTemplate(requireTypeSafeExpressions = false)
        - at HelloResource /hello.txt:1

A working example might be

Either

    @CheckedTemplate(requireTypeSafeExpressions = false)
    public static class Templates {
        public static native TemplateInstance hello(); 
    }

    @GET
    @Produces(MediaType.TEXT_PLAIN)
    public TemplateInstance get(@QueryParam("name") String name) {
        return Templates.hello().data("name", name);  
    }

Or :

    @CheckedTemplate
    public static class Templates {
        public static native TemplateInstance hello(String name); 
    }

    @GET
    @Produces(MediaType.TEXT_PLAIN)
    public TemplateInstance get(@QueryParam("name") String name) {
        return Templates.hello(name);  
    }

Here is what comes to my mind about this.

• Making the sample compile by adding early noise with optional parameter (requireTypeSafeExpressions = false)
  • Maybe along with a note that explains briefly why there is (requireTypeSafeExpressions = false) and tells that it will be explained a few paragraphs later

or

• Introducing the concept of template parameters
  • but it redundant beacause it is already done later

[gsmet]

@mkouba could you have a look at this one?

[mkouba]

Yes, it should be the variant with public static native TemplateInstance hello(String name). The ref guide should be correct: https://quarkus.io/guides/qute-reference#typesafe_templates

[quarkus-bot]

/cc @mkouba