home.md

@@ -90,6 +90,53 @@ For organisations, we usually set up a special organisation-admin account, who i
 
 Alternatively, the [groupfolder app](https://nextcloud.com/blog/new-version-of-groupfolders-app-is-coming/) may be an option which we are currently testing.
 
+## Circles
+
+This is a quick guide to the nextcloud circles extension.
+
+Circles allows users to create their own groups for sharing, messaging etc.
+It is very practical for sharing the storage space of your faircloud with other faircloud users.
+
+To share your cloudspace with other you have to create a circle in your circles app on the top side of the webview of your faircloud.
+
+![circles1](uploads/c49639bda42332bc0161fdfdc7039f9c/circles1.png)
+
+There you have an overview of the existing circles. 
+
+### Creating a circle
+
+In the top left searchbar you can type a name, choose the circle type and create a circle. The following types exist:
+
+- Personal Circle: A circle for yourself to share links with etc. The circle is not accessible by anybody else but yourself.
+
+- Public Circle: A Circle that anyone can access and join. It's visible for everyone using our cloud.
+
+- Closed Circle: Can only be joined if allowed by an admin. This circle is visible for everyone.
+
+- Secret Circle: Cannot be seen by other users. Only can be joined if you're invited by an admin.
+
+All circles can still be managed by admins and owners.
+
+The circles can be managed by choosing the circle you want to edit in the dark grey bar second from the left where you can search for circles. 
+
+![cirles2](uploads/a17cf5906dd34565fec78fb49c2e7d91/cirles2.png)
+
+Editing the name, description as well as kicking users and deleting the circle can only be done by owners. Admins can add users, change roles and connect groups with the circle.
+
+### Sharing a file or folder
+
+You can share a file or a folder with your circle by clicking on the sharing button (3 dots connected by two lines, on the right to the folder/file name). After clicking there will be a menu for sharing visible on the right side. There you type in the name of your newly created circle and press Enter. Now the file or folder is shared with your circle.
+
+![circles_sharefolder_barb_marked](uploads/c95cb0a6934cc8cad920e8b629f78bc3/circles_sharefolder_barb_marked.png)
+
+After successfully sharing the folder you see a text saying "Shared" next to the sharing symbol.
+As well as the name of your circle listed in the sharing menu.
+
+![see_shared_circle_marked](uploads/d4b0f5613d17fe2a892e180e744a3d38/see_shared_circle_marked.png) 
+
+Now you have created a shared folder for your circle and can start your collabrative work!
+
+
 ## Adding external storage
 
 Any user can [add an external storage](https://faircloud.eu/nextcloud/index.php/settings/user/externalstorages), which support WebDAV or sftp.