Clarify difference between data-sly-include and data-sly-resource

[tripodsan]

the spec does not clearly state the difference between data-sly-include and data-sly-resource.

it would be nice to give an example.

[tripodsan]

when looking at the implementations of the extensions:

• https://github.com/apache/sling-org-apache-sling-scripting-sightly/blob/master/src/main/java/org/apache/sling/scripting/sightly/impl/engine/extension/IncludeRuntimeExtension.java
• https://github.com/apache/sling-org-apache-sling-scripting-sightly/blob/master/src/main/java/org/apache/sling/scripting/sightly/impl/engine/extension/ResourceRuntimeExtension.java

it looks like data-sly-resource creates a new internal request against the sling engine, where as data-sly-include looks for the specified script/servlet and executes it, using the same request context, i.e. the same current resource.

so data-sly-resource can be compared with a <jsp:include page="" /> and data-sly-include is similar to <%@ include file="" %>

@raducotescu correct?

[raducotescu]

@tripodsan, that's the correct analogy and the specification does mention this:

data-sly-include:

• Includes the output of a rendering script run with the current context.

data-sly-resource:

• Includes a rendered resource.

[tripodsan]

would be nice to update the specification. imo, only people familiar with sling might possibly understand the current description. I will provide a PR.