docs icon indicating copy to clipboard operation
docs copied to clipboard

Help Wanted: Tables aren't consistently formatted

Open cwarnermm opened this issue 1 year ago • 10 comments
trafficstars

The product docs source code uses a few different types of syntax for table-based content which applies inconsistent default CSS look & feel across the site.

Examples:

  • https://docs.mattermost.com/about/faq-product.html#what-features-are-available-on-different-mattermost-clients
  • https://docs.mattermost.com/configure/calls-deployment.html#modes-of-operation
  • https://docs.mattermost.com/upgrade/important-upgrade-notes.html

Goal: Provide a standard way to display all table-based content site wide.

  1. Investigate pros & cons of each approach.
  2. Align on a single standard approach.
  3. Work with UX to ensure that table formatting is sufficiently easy to scan/read, particularly in cases where tables are complex, such as the Important Upgrade Notes page.

cwarnermm avatar Apr 03 '24 17:04 cwarnermm

Network table is weirdly large image

cwarnermm avatar Apr 04 '24 16:04 cwarnermm

https://pradyunsg.me/furo/reference/tables/

cwarnermm avatar Apr 08 '24 16:04 cwarnermm