In #23287 (comment), @Trott wrote:

Also: The whole "things called 'guides' are in two different places and mean subtly different things, and oh yeah the website is generated in this repo over here except for the docs which are generated over here".... If there's some way that information could have been something could have been surfaced naturally, I'd love to hear what it is. Because that stuff is confusing and probably only a few people know it.

Maybe the guides directory in this repo can be renamed to something that makes it clear they are internal to the project and/or moved out of docs?

Maybe a bot can comment on any PR that adds a new file to the docs/guides letting the user know that these guides are for internal use and if they meant to create something for end users, then they should close this PR and open a new PR over in this other repo?

Other ideas?