Skip to content

Commit 836ed29

Browse files
authored
Update docs/syntax/images.md
1 parent 077c0d2 commit 836ed29

File tree

1 file changed

+2
-0
lines changed

1 file changed

+2
-0
lines changed

docs/syntax/images.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,8 @@ Images include screenshots, inline images, icons, and more. Syntax for images is
99
:::{note}
1010
If a page uses a relative image path, it must be relative to the `toc.yml` or `docset.yml` that includes the page rather than relative to the page itself.
1111
This type of relative path may fail to render when you run a local build, thus it's generally preferable to use an absolute path, for example: `/solutions/images/observability-apm-app-landing.png`.
12+
13+
Irrespective of whether you use relative or absolute paths, if you reference an image that exists in a folder that is higher in the tree than the `toc.yml` file, it is at risk of being broken if the assembler rehomes this subtree and causes a warning in the build.
1214
:::
1315

1416
## Block-level images

0 commit comments

Comments
 (0)