diff --git a/screening/source/java/ch/systemsx/cisd/openbis/dss/etl/dto/api/v1/BasicDataSetInformation.java b/screening/source/java/ch/systemsx/cisd/openbis/dss/etl/dto/api/v1/BasicDataSetInformation.java
index 84e475238305917f81b2015dc3e1b314abde5ed2..99bcf07c6308dcf4cd84a876fa3c836c976150d9 100644
--- a/screening/source/java/ch/systemsx/cisd/openbis/dss/etl/dto/api/v1/BasicDataSetInformation.java
+++ b/screening/source/java/ch/systemsx/cisd/openbis/dss/etl/dto/api/v1/BasicDataSetInformation.java
@@ -50,7 +50,14 @@ public class BasicDataSetInformation extends DataSetInformation
         this.fileFormatTypeCode = fileFormatCode;
     }
 
-    /** Mandatory: sets attributes of the connected sample */
+    /**
+     * Sets attributes of the connected sample - optional.
+     * <p>
+     * Alternatively, call
+     * {@link ch.systemsx.cisd.etlserver.registrator.api.v1.IDataSetUpdatable#setSample(ch.systemsx.cisd.openbis.dss.generic.shared.api.internal.v1.ISampleImmutable)}
+     * on the object returned by
+     * {@link ch.systemsx.cisd.etlserver.registrator.api.v1.IDataSetRegistrationTransaction#createNewDataSet()}.
+     */
     public void setSample(String sampleSpaceCode, String sampleCode)
     {
         super.setSpaceCode(sampleSpaceCode);