doc: searches for sys_reboot() are inconsistant

[pearson]

It is difficult to find documentation on sys_reboot() and associated symbols. Searching through the main Zephyr documentation site gives different search results from a search starting from the Zephyr API Documentation Files List.

Searching through the Zephyr documentation site:

• searching for sys_reboot() only lists a couple mentions of the function, as well as CONFIG_REBOOT, but no documentation on the function itself
• searching for SYS_REBOOT_WARM gives no results
• searching for SYS_REBOOT_COLD lists one result of the define in use, but no description of it

Searching from [File List](https://docs.zephyrproject.org/latest/doxygen/html/files.html) or other pages in the File List tree:

• typing sys_reboot(), SYS_REBOOT_WARM, or SYS_REBOOT_COLD into the search box shows a drop-down menu with a link to reboot.h File Reference. This page does show some minimal documentation for sys_reboot().

My expectation would be to find search results for sys_reboot() when doing so from the main Zephyr documentation page.

[manoj153]

Concur, I do not know WARM vs COLD.

[github-actions]

This issue has been marked as stale because it has been open (more than) 60 days with no activity. Remove the stale label or add a comment saying that you would like to have the label removed otherwise this issue will automatically be closed in 14 days. Note, that you can always re-open a closed issue at any time.

[owain-incus]

Kind of a pretty basic functionality one would want to use.
Should be documented.

[bandogora]

Bumping this because I'm looking for documentation right now.

[kartben]

Related to issue #55173.

[kartben]

This will be fixed with #60920, courtesy of @gmarull ❤️