Update javadoc

git-svn-id: https://svn.apache.org/repos/asf/sling/trunk@1765763 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/src/main/java/org/apache/sling/spi/resource/provider/ObserverConfiguration.java b/src/main/java/org/apache/sling/spi/resource/provider/ObserverConfiguration.java
index 95bc3db..326e570 100644
--- a/src/main/java/org/apache/sling/spi/resource/provider/ObserverConfiguration.java
+++ b/src/main/java/org/apache/sling/spi/resource/provider/ObserverConfiguration.java
@@ -33,6 +33,13 @@
  * {@link Object#equals(Object)} method. Two configurations are equal, if they
  * have exactly the same parameters.
  *
+ * A resource provider implementation observation must support sending remove
+ * events as explained in {@link org.apache.sling.api.resource.observation.ResourceChangeListener}.
+ * If an observer configuration contains a pattern or is limited to a sub tree,
+ * removal events not matching the pattern or removing events of parents of
+ * that sub tree must be provided to the listener nevertheless - if the
+ * listener is interested in resource remove events.
+ *
  * @since 1.0.0 (Sling API Bundle 2.11.0)
  */
 @ProviderType