# HG changeset patch
# User Goffi <goffi@goffi.org>
# Date 1750950800 -7200
# Node ID 7a97408f32bb8ed93a809545e7dfa867ccd247ac
# Parent  8400d3b5851506836d8389f8c7ca6e5d5899cb1d
doc (user/chat): Document header and data policy:

Document chat header, and Data Policy badge and panel.

fix 460

diff -r 8400d3b58515 -r 7a97408f32bb doc/user/chat.rst
--- a/doc/user/chat.rst	Thu Jun 26 17:12:37 2025 +0200
+++ b/doc/user/chat.rst	Thu Jun 26 17:13:20 2025 +0200
@@ -23,6 +23,28 @@
 - **Right panel**: Provides information about the current discussion, such as participants
   in a chat room.
 
+
+Main Panel Header
+-----------------
+
+The main panel header displays information about the current conversation.
+
+On the left side of the header, you'll find a button to toggle the visibility of the left
+panel. Next to this button is the identifier (JID) of the conversation recipient. This
+recipient can be a single user or a group chat room.
+
+When available, a "Data Policy" badge may appear next to the JID. This badge indicates the
+privacy and data practices of the service associated with the recipient. The badge is
+scored on a scale of ten and uses the following color scheme:
+
+- **Green:** Indicates good data practices and respect for privacy.
+- **Yellow:** Indicates a moderate score – data practices are neither good nor bad.
+- **Red:** Indicates poor data practices and potential privacy concerns.
+
+Hovering or touching the Data Policy badge will open a report panel with more detailed
+information about the service's data handling.
+
+
 Threads and Replies
 -------------------