Ja pensou em usar Open Api para documentar a API? Você consegue gerar uma documentação interativa em HTML automaticamente a partir da especificação da API.
Cria um repositório git com a especificação da API (preferencialmente no repositório do próprio projeto). Os devs vão sempre consultar essa documentação (e podem usar os exemplos dela)