From 3d93e489c4957e32d6af1ce66a495c5b6cd5d1e5 Mon Sep 17 00:00:00 2001
From: dogeystamp <dogeystamp@disroot.org>
Date: Mon, 22 May 2023 12:16:45 -0400
Subject: [PATCH] docs/files.rst: added note about null ownership

---
 docs/admin.rst | 2 ++
 docs/files.rst | 5 +++++
 2 files changed, 7 insertions(+)

diff --git a/docs/admin.rst b/docs/admin.rst
index 8153c54..baf98d9 100644
--- a/docs/admin.rst
+++ b/docs/admin.rst
@@ -23,6 +23,8 @@ Currently, server settings are represented by the following object:
         "default_permissions": ["PERMISSION1", "PERMISSION2"]
     }
 
+.. _admin_anon_perms:
+
 Anonymous permissions
 ^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/docs/files.rst b/docs/files.rst
index 4709651..46f739a 100644
--- a/docs/files.rst
+++ b/docs/files.rst
@@ -64,6 +64,11 @@ In JSON, a file share has the following properties::
       - Read-only
       - UUID that uniquely identifies this share.
 
+.. note::
+
+   Share ownership can be changed by changing ``owner_name``.
+   Do note that setting it to ``null`` is equivalent to :ref:`unauthenticated users<admin_anon_perms>` owning the share.
+
 .. _files_metadata_api:
 
 Metadata API