- * Represent a change (addition,replacement,deletion) of the node or one
- * of its direct children.
+ * Represent a change (addition,replacement,deletion) of the node or one of its direct
+ * children.
+ * <p>
+ * Note that this is done in the <i>binding independent</i> data tree and so the behavior
+ * might be counterintuitive when used with <i>binding aware</i> interfaces particularly
+ * when it comes to lists. The list itself is a node in the <i>binding independent</i> tree,
+ * which means that if you want to listen on new elements you must listen on the list itself
+ * with the scope of {@link #ONE}.
+ * <p>
+ * As an example, in the below YANG snippet, listening on <tt>node</tt> with scope
+ * {@link #ONE} would tell you if the <tt>node-connector</tt> list was created or deleted,
+ * but not when elements were added or removed from the list assuming the list itself
+ * already existed.
+ *
+ * <pre>
+ * container nodes {
+ * list node {
+ * key "id";
+ * leaf id {
+ * type string;
+ * }
+ * list node-connector {
+ * leaf id {
+ * type string;
+ * }
+ * }
+ * }
+ * }
+ * </pre>