Já vi os outros posts seu, trabalho interessante!
Uma dica para a documentção: Não separa o endpoint do retorno, seria melhor ver o endpoint e logo abaixo dele o retorno e tudo sobre ele. Ter 2 listas é meio estranho.
Opa,muito boa observação. estou trabalhando em uma documentação mais profissional . e a sua idéia veio a calhar. muito obrigado
atualizei agora la seguindo sua recomendação.