Documentação

Bom dia!
Eu nunca trabalhei com documentação, e agora estou gerando a doc de um programa extenso e com muitas sql querys.

Gostaria de saber qual a melhor forma de se documentar, se existe algum tipo de padrão, se é bom sintetizar bastante tecnicamente, dando um overview da classe, atributos, métodos… ou se aprofundar tecnicamente explicando até as extensas querys em sí.

Alguém dá um norte?

Obrigado!