Clarify that some interface are not meant to be implemented

This make sure that apps don't implement this interfaces and gives us
more liberty to add new methods to them (as long as it is compatible
from an usage point of view)

Signed-off-by: Carl Schwan <carl@carlschwan.eu>
Co-authored-by: Vincent Petry <vincent@nextcloud.com>

diff --git a/lib/public/Share/IManager.php b/lib/public/Share/IManager.php
index 8b1f5144b9aa37dea358cc2b32759649a651ab20..ff4b6af19e011fac143027a755520207fea28cf6 100644 (file)
--- a/lib/public/Share/IManager.php
+++ b/lib/public/Share/IManager.php
@@ -37,7 +37,11 @@ use OCP\Share\Exceptions\GenericShareException;
 use OCP\Share\Exceptions\ShareNotFound;
 
 /**
- * Interface IManager
+ * This interface allows to manage sharing files between users and groups.
+ *
+ * This interface must not be implemented in your application but
+ * instead should be used as a service and injected in your code with
+ * dependency injection.
  *
  * @since 9.0.0
  */

diff --git a/lib/public/UserStatus/IManager.php b/lib/public/UserStatus/IManager.php
index f709768d717e815f5c42d2d5691a51d0a8931f34..354a1e19ee9d490d54147568620408b478847ba2 100644 (file)
--- a/lib/public/UserStatus/IManager.php
+++ b/lib/public/UserStatus/IManager.php
@@ -26,7 +26,11 @@ declare(strict_types=1);
 namespace OCP\UserStatus;
 
 /**
- * Interface IManager
+ * This interface allows to manage the user status.
+ *
+ * This interface must not be implemented in your application but
+ * instead should be used as a service and injected in your code with
+ * dependency injection.
  *
  * @since 20.0.0
  */