Este repositório contem um exemplo de como criar uma documentação para uma API utilizando o TypeSpec, uma linguagem desenvolvida pela Microsoft para facilitar a vida de nós devs durante a escrita da documentação de uma API.
Tem um vídeo no meu canal lá no Youtube explicando como utilizar essa linguagem e os benefícios em utilizá-la (o código desse repositório é resultado desse vídeo).
Vídeo: Isso vai mudar totalmente a forma como você documenta suas APIs