From 58410b7323a3b389f9ea02af832c1fe172a74b4f Mon Sep 17 00:00:00 2001 From: Carl Schwan Date: Fri, 4 Mar 2022 11:42:03 +0100 Subject: [PATCH] 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 Co-authored-by: Vincent Petry --- lib/public/Share/IManager.php | 6 +++++- lib/public/UserStatus/IManager.php | 6 +++++- 2 files changed, 10 insertions(+), 2 deletions(-) diff --git a/lib/public/Share/IManager.php b/lib/public/Share/IManager.php index 8b1f5144b9aa3..ff4b6af19e011 100644 --- 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 index f709768d717e8..354a1e19ee9d4 100644 --- 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 */