I think I’ve settled on JSON-LD for my machine-readable stuff, but dang it’s poorly documented. Examples are thin on the ground, and nobody seems to be using it for full discoverability. So I’m breaking new ground, and just throwing out JSON-LD for each page, with links as I understand them, and writing a client that will traverse them.
And trying to reconcile “RESTful” with “static” which is entirely impractical but a lot of fun.