Skip to main content
Aviso removido Chamar atenção por Daniel Falbel
Fim da Recompensa com Taisbevalle's answer escolhido por Daniel Falbel
Tweeted twitter.com/StackOverflowPT/status/811696941251915776
título editado
Link
viana
  • 27,7mil
  • 26
  • 96
  • 198

como Como documentar códigos em SQL?

Aviso adicionado Chamar atenção por Daniel Falbel
Recompensa Oferecida vale 100 pontos de reputação por Daniel Falbel
Fonte Link
Daniel Falbel
  • 12,5mil
  • 25
  • 57

como documentar códigos em SQL

Quando escrevo códigos em R, a maneira correta de documentar é no próprio código, em forma de comentários iniciados com uma marcação especial #'.

#' Add together two numbers.
#' 
#' @param x A number.
#' @param y A number.
#' @return The sum of \code{x} and \code{y}.
#' @examples
#' add(1, 1)
#' add(10, 1)
add <- function(x, y) {
  x + y
}

Depois existe uma ferramenta chamada roxygen que transforma esses comentários do código em um arquivo de documentação.

inserir a descrição da imagem aqui

Esse formato, mantém a documentação próxima do código, deixando muito mais fáceis as suas atualizações. Além disso, é possível produzir documentos padronizados de documentação.

Minha pergunta é: Como fazer algo parecido com isso para o SQL (especificamente para SQL Server)?