Tables
April 15, 2026 · View on GitHub
Guidance
Use tables to present comparative or structured information that has a clear relationship between rows and columns. Keep table content concise. Use sentence case for column headers.
Examples
Do:
Use Instead of allow list whitelist deny list blacklist primary master
Don't:
Use a table to present a simple list that would read naturally as prose or bullets.
Notes
Never use a colon to introduce a table.
Don't use tables as page layout tools or visual dividers.
Use parallel structure within columns — each cell in a column should follow the same grammatical pattern.
Include a header row. Use sentence case for all header text.