(blog author here) Thanks for the feedback. I've raised this issue as well in the past and I think it has already gotten better.

AFAIU there's a dedicated page planned for osh/ysh when you click on the headline which should make it much more clear.