diff --git a/api_docs/message-formatting.md b/api_docs/message-formatting.md index a63fec6dae..191780e170 100644 --- a/api_docs/message-formatting.md +++ b/api_docs/message-formatting.md @@ -136,11 +136,13 @@ generate an image preview element with the following format: ``` +**Changes**: See [Changes to image formatting](#changes-to-image-formatting). + ### Image-loading placeholders -If the server has not yet generated thumbnails for the image yet at -the time the message is sent, the `img` element will be a temporary -loading indicator image and have the `image-loading-placeholder` +If the server has yet to generate thumbnails for the image by +the time the message is sent, the `img` element will temporarily +reference a loading indicator image and have the `image-loading-placeholder` class, which clients can use to identify loading indicators and replace them with a more native loading indicator element if desired. For example: