Add documentation for mark favorite as favorite

user_manual/groupware/contacts.rst

@@ -7,7 +7,7 @@ be installed separately from our App Store.
 
 The Nextcloud Contacts app is similar to other mobile contact applications, but
 with more functionality.
-This section covers the basic features that will help you maintain your address book
+Let's run through basic features that will help you maintain your address book
 in the application.
 
 Below, you will learn how to add contacts, edit or remove contacts, upload a
@@ -155,6 +155,19 @@ If either of the contacts are part of a group(s), by default the merged contact
 
 .. note:: Currently you are only able to merge two contacts at a time, and you are naturally only able to merge contacts that can be modified by you. If the merging action is disabled, check that you selected contacts that match those conditions.
 
+Mark contacts as favorite
+-------------------------
+
+.. versionadded:: 8.4
+
+Now you can mark contacts as favorites to always find them at the top of your contacts list, without needing to search or filter.
+
+To mark a contacts as favorite, hover over a contact, a star will show on the right. Click the star and a yellow star will appear on the contact's avatar to confirm it's been marked as a favorite.
+
+To remove it form the favorite list - Hover over a favorited contact, and click the star on the right. The star will disappear and the contact will return to its alphabetical position in the list.
+
+.. figure:: ../images/mark_favorite.png
+
 Organize your Contacts with Contact Groups
 ------------------------------------------
 
@@ -240,10 +253,6 @@ Team options
 
 Various self-explanatory options are available to configure a team, to manage invites and membership, visibility of the team, allowance of other team membership and password protection.
 
-**Prevent teams from being a member of another team**
-
-When this option is enabled, the team can no longer be directly added as a member of another team. However, this restriction only applies to new direct additions. Existing memberships are kept, and inherited memberships are still possible if this team belongs to a parent team that gets added elsewhere.
-
 Shared items
 ~~~~~~~~~~~~
 .. versionadded:: 5.5 Nextcloud  25 or newer