RFC: 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>
nextcloud · Mar 4, 2022 · 58410b7 · 58410b7
1 parent 8a52591
commit 58410b7
Show file tree

Hide file tree

Showing 2 changed files with 10 additions and 2 deletions.
diff --git a/lib/public/Share/IManager.php b/lib/public/Share/IManager.php
@@ -37,7 +37,11 @@
 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
@@ -26,7 +26,11 @@
 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
  */