Add images section (#4412)

Signed-off-by: natebower <102320899+natebower@users.noreply.github.com>
This commit is contained in:
Nathan Bower 2023-06-28 15:58:46 -04:00 committed by GitHub
parent 31c8e1e0c1
commit 81836baabe
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 10 additions and 2 deletions

View File

@ -160,8 +160,6 @@ The following table lists acronyms that you don't need to spell out.
- Use bold text for all UI elements, including pages, panes, and dialog boxes. In all cases, emphasize what the user must do as opposed to talking about the UI element itself.
- Reference images in the text that precedes them. For example, "..., as shown in the following image."
- Stacked headings should never appear in our content. Stacked headings are any two consecutive headings without intervening text. Even if it is just an introductory sentence, there should always be text under any heading.
- Use italics for the titles of books, periodicals, and reference guides. However, do not use italics when the title of a work is also a hyperlink.
@ -171,6 +169,16 @@ The following table lists acronyms that you don't need to spell out.
2. When referring to API operations by the exact name of the endpoint, use lowercase with code format (example: "`_field_caps` API").
3. When describing API operations but not using the exact name of the endpoint, use lowercase (example: "field capabilities API operations" or "field capabilities operations").
### Images
- Add introductory text that provides sufficient context for each image.
- Add ALT text that describes the image for screen readers.
- When youre describing the location of an image, use words such as *preceding*, *previous*, or *following* instead of *above* and *below*.
- Text that introduces an image should be a complete sentence and end with a period, not a colon.
### Links
- **Formal cross-references**: In most cases, a formal cross-reference (the title of the page you're linking to) is the preferred style because it provides context and helps readers understand where they're going when they choose the link. Follow these guidelines for formal cross-references: