Skip to content

Clarify the use of titles and captions with tables and images #534

@alexpdp7

Description

@alexpdp7

Titles use title case, while captions use sentence case.

However, it is not obvious that what we use for tables are titles; IBM calls those captions:

https://www.ibm.com/docs/en/ibm-style?topic=format-tables#captions

So if we followed that, then:

https://stylepedia.net/style/6.1/#heading-styles

Tells us that captions are sentence case, which is contrary to what we are currently doing.

I suggest we clarify that the thing we put on a table is a "title", not a caption.

Metadata

Metadata

Assignees

Labels

enhancementWill improve the guide but is not a bug or blocker.

Type

No type

Projects

No projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions