Documentation foundations for humans and AI

Before we rush to optimise our docs for AI, we need to get the foundations right.