Okay, so at the end of my last babble, I said that I was going to migrate from MkDocs to Astro, after having only just recently moved to MkDocs, and in fact not even fully completed that migration.
Well, after trying to get links-in-Obsidian to work nicely with links-in-Astro, I gave up, went looking for another solution, and found Quartz.
But, on my way there, I found Diátaxis, “a way of thinking about and doing documentation” - specifically, technical documentation.
I’m tired after a day of sorting files and testing site generators, so I’m not going to repeat any of it here, but did want to note it so I can find it again in the future.