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.
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)?