NX-507: Added more explanation in javadoc