deprecate: announce deprecation of unsafe addFromCollection method

We still use it internally, but I plan to replace it at some point in future. We should be able to generate at least basically valid entities from external providers. And if not we can still work around this with a custom, private subclass of RoCrate.

Author: Pfeil

src/main/java/edu/kit/datamanager/ro_crate/Crate.java

@@ -151,6 +151,15 @@ public interface Crate {
 
   void setUntrackedFiles(Collection<File> files);
 
+  /**
+   * Unsafely adds a collection of entities to the crate.
+   * <p>
+   * WARNING: This method does not perform any checks and may lead to an inconsistent crate state.
+   *
+   * @param entities the collection of entities to add
+   * @deprecated use individual add methods to ensure crate consistency. If you really need an unchecked method, consider creating a subclass or contact us at our issue tracker so we can discuss replacements before removal.
+   */
+  @Deprecated(forRemoval = true)
   void addFromCollection(Collection<? extends AbstractEntity> entities);
 
   void addItemFromDataCite(String locationUrl);