kwin commented on code in PR #59:
URL: 
https://github.com/apache/sling-org-apache-sling-api/pull/59#discussion_r2124506522


##########
src/main/java/org/apache/sling/api/resource/ResourceResolver.java:
##########
@@ -769,10 +776,12 @@ public interface ResourceResolver extends Adaptable, 
Closeable {
     /**
      * Add a child resource to the given parent resource.
      * The changes are transient and require a call to {@link #commit()} for 
persisting.
+     * The mandatory resource type is either determined by the property 
{@value ResourceResolver#PROPERTY_RESOURCE_TYPE} or set by the underlying 
resource provider to some value.
+     * The optional resource super type is determined by the property {@value 
ResourceResolver#PROPERTY_RESOURCE_SUPER_TYPE}.
      *
      * @param parent The parent resource
      * @param name   The name of the child resource - this is a plain name, 
not a path!
-     * @param properties Optional properties for the resource
+     * @param properties Optional properties for the resource (may be 
<code>null</code>).

Review Comment:
   Usually all arguments not having null annotations may be null (compare with 
https://sling.apache.org/documentation/development/null-analysis.html). Only 
return values are usually annotated `@Nullable`.



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: dev-unsubscr...@sling.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org

Reply via email to