From bdc116b4e44631371459aa4a68f1c1fae7f4fa57 Mon Sep 17 00:00:00 2001
From: MCG357 <magou@odoo.com>
Date: Fri, 13 Feb 2026 20:58:29 +0000
Subject: [PATCH] [IMP] Contributing: list table customization parameters

X-original-commit: 1650bbbcf813be0ff3581c780384c5f6d8cd78d1
Co-authored-by: Felicia Kuan <feku@odoo.com>
---
 content/contributing/documentation/rst_guidelines.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/content/contributing/documentation/rst_guidelines.rst b/content/contributing/documentation/rst_guidelines.rst
index 76754f1b88..b5a0a0bce9 100644
--- a/content/contributing/documentation/rst_guidelines.rst
+++ b/content/contributing/documentation/rst_guidelines.rst
@@ -883,6 +883,17 @@ the rows and the second level represents the columns.
                - France
                - Turquoise
 
+.. tip::
+   Use specific parameters to adjust the appearance and layout of list tables:
+
+   - `:class: table-striped`: Apply alternating row colors.
+   - `:class: table-sticky-header`: Keep the header row fixed while scrolling.
+   - ``:widths:``: Define column proportions. Avoid using `auto`. For example: ``:widths: 25 25 50``.
+
+.. seealso::
+   `Docutils documentation on reStructuredText tables
+   <https://docutils.sourceforge.io/docs/ref/rst/directives.html#tables>`_
+
 Grid tables
 -----------