Ping @AnnsAnns :)

Uuuh, this made me stumble upon the fact that some guides are now twice in the source tree - that's really not optimal (see e.g. https://github.com/RIOT-OS/RIOT/blob/94029df898052d6343a0f195ccf88ed1f9ab9839/doc/doxygen/src/build-in-docker.md and https://github.com/RIOT-OS/RIOT/blob/master/doc/guides/build-system/build-in-docker.md).

I think we should remove the doxygen version (but make sure we prominently link to the guides from doxygen first).

Uuuh, this made me stumble upon the fact that some guides are now twice in the source tree - that's really not optimal (see e.g. https://github.com/RIOT-OS/RIOT/blob/94029df898052d6343a0f195ccf88ed1f9ab9839/doc/doxygen/src/build-in-docker.md and https://github.com/RIOT-OS/RIOT/blob/master/doc/guides/build-system/build-in-docker.md).

I think we should remove the doxygen version (but make sure we prominently link to the guides from doxygen first).

I think the idea was to switch gracefully but that was also a few months ago by now and Id call the guide site production ready by now. There was never any official decision (that I know of) whether or not to transition all old guides, which is why we only had a select amount of guides to showcase the possibilities / how the guide site would look.

Uuuh, this made me stumble upon the fact that some guides are now twice in the source tree - that's really not optimal (see e.g. >https://github.com/RIOT-OS/RIOT/blob/94029df898052d6343a0f195ccf88ed1f9ab9839/doc/doxygen/src/build-in-docker.md and
https://github.com/RIOT-OS/RIOT/blob/master/doc/guides/build-system/build-in-docker.md).

Hmmm ... I didn't notice that ... but after first look examples directories in doxygen version looks OK.

I think we should remove the doxygen version (but make sure we prominently link to the guides from doxygen first).

I think the idea was to switch gracefully but that was also a few months ago by now and Id call the guide site production ready by now. There was never any official decision (that I know of) whether or not to transition all old guides, which is why we only had a select amount of guides to showcase the possibilities / how the guide site would look.

We just discussed this briefly at the maintainers meeting and came up with the following:

• deprecate the doxygen version using the @deprecated doxygen tag at the top of the file (let's keep fingers crossed that actually works), with pending for removal after two releases from now (2025.11), deleting all its content and replacing it with a link to the guides site (before deleting make sure there were no diverging changes between the doxygen version and the guides site)
• add a prominent link to the general guides site on doxygen, either in the top bar, or in the left navigation bar

Would you be willing to help us with this @AnnsAnns ?

(this is of course all follow-up of this PR, which looks good to me)

I think we should remove the doxygen version (but make sure we prominently link to the guides from doxygen first).

I think the idea was to switch gracefully but that was also a few months ago by now and Id call the guide site production ready by now. There was never any official decision (that I know of) whether or not to transition all old guides, which is why we only had a select amount of guides to showcase the possibilities / how the guide site would look.

We just discussed this briefly at the maintainers meeting and came up with the following:

* deprecate the doxygen version using the `@deprecated` doxygen tag at the top of the file (let's keep fingers crossed that actually works), with pending for removal after two releases from now (2025.11), deleting all its content and replacing it with a link to the guides site (before deleting make sure there were no diverging changes between the doxygen version and the guides site)

* add a prominent link to the general guides site on doxygen, either in the top bar, or in the left navigation bar

Would you be willing to help us with this @AnnsAnns ?

Sure sounds good, will help :)

Murdock results

✔️ PASSED

39f1933 doc/guides: fix examples directories

Artifacts

• Documentation preview