Documentation formatting issue?

[Daniel Singer]

On this page https://docs.nordicsemi.com/bundle/ncs-latest/page/zephyr/build/dts/howtos.html#set_devicetree_overlays and many others in this documentation, it appears that angle brackets and ampersands are not being rendered properly, making the examples extremely difficult to read. I am new to device tree and all that, but from what I have read so far, these "&.mp" are meant to be simply "&", and "&.t;" represent "<" and ">" as they surround text.

Google chrome browser, Version 142.0.7444.163 (Official Build) (64-bit) -- Windows 11 PRo 23H2 Build 22631.5984

[Turbo J]

Might be a bug in documentation generator. You can view the source in the SDK itself, its in the file:

zephyr/doc/build/dts/howto.rst

Note that it is correctly formatted when you select the online documentation for the 3.2.1 SDK version instead of "latest".

[Øyvind]

Hello, and thanks for reporting! Yes, I see the issue as well when using documentation from lastest brach. We would recommend using latest tagged version, in this case v3.2.1. This seems to render as intended. 
https://docs.nordicsemi.com/bundle/ncs-3.2.1/page/zephyr/build/dts/howtos.html#set_devicetree_overlays

Let me know how that works for you.

Kind regards,
Øyvind