guidance.mdx

title	Table Guidance
component	table
description	Guidelines and best practices for using tables effectively.

Function

Tables are used to organize structured data into rows and columns. They help users quickly scan, compare, and understand information.

Tables are useful for:

• Presenting structured data
• Comparing multiple values
• Displaying logs and metrics
• Listing users or resources

---

Usage

Use tables when:

• Data must be compared
• Information is structured
• Users need quick scanning
• Displaying rows and columns

Avoid using tables when:

• Content is mostly text
• Layout is simple
• Data does not require comparison

---

Best Practices

Follow these best practices when using tables:

• Use clear headers
• Avoid too many columns
• Keep rows readable
• Use pagination for large datasets
• Maintain consistent spacing

Use Clear Headers

Always include headers for better readability.

<table>
  <thead>
    <tr>
      <th>Name</th>
      <th>Role</th>
    </tr>
  </thead>
</table>