Add example to DocBlockenh/account-set-all-properties

Signed-off-by: Christopher Ng <chrng8@gmail.com>

1 files changed, 34 insertions, 0 deletions

diff --git a/lib/public/Accounts/IAccount.php b/lib/public/Accounts/IAccount.php
index dcec17f9363..383f21068a9 100644
--- a/lib/public/Accounts/IAccount.php
+++ b/lib/public/Accounts/IAccount.php
@@ -76,6 +76,40 @@ interface IAccount extends \JsonSerializable {
 	 *
 	 * @param array<string, array<string, string>>|array<string, array<int, array<string, string>>> $properties
 	 *
+	 * e.g. `[
+	 *   'displayname' => [
+	 *     'name' => 'displayname',
+	 *     'value' => 'Jonathan Smith',
+	 *     'scope' => 'v2-federated',
+	 *     'verified' => '0',
+	 *     'verificationData' => '',
+	 *   ],
+	 *   'email' => [
+	 *     'name' => 'email',
+	 *     'value' => 'jonathan@example.org',
+	 *     'scope' => 'v2-federated',
+	 *     'verified' => '0',
+	 *     'verificationData' => '',
+	 *   ],
+	 *   // ...
+	 *   'additional_mail' => [
+	 *     [
+	 *       'name' => 'additional_mail',
+	 *       'value' => 'jon@example.org',
+	 *       'scope' => 'v2-local',
+	 *       'verified' => '0',
+	 *       'verificationData' => '',
+	 *     ],
+	 *     [
+	 *       'name' => 'additional_mail',
+	 *       'value' => 'jon@earth.org',
+	 *       'scope' => 'v2-local',
+	 *       'verified' => '0',
+	 *       'verificationData' => '',
+	 *     ],
+	 *   ],
+	 * ]`
+	 *
 	 * @since 24.0.0
 	 */
 	public function setAllPropertiesFromJson(array $properties): IAccount;