A principal função dos modelos da Kondado é abstrair as regras de negócio e cruzamentos de dados em uma única tabela já preparada e transformada que possa ser consumida por usuários não técnicos, ferramentas de visualização e como feature stores.
Nesse sentido, fornecer uma documentação do seu modelo é fundamental para os seus “consumidores” possam ter ainda mais liberdade para se auto-servir e explorar os dados da empresa. Documentar modelos é uma das principais funções de qualquer analytics engineer.
Acessando a documentação de um modelo
Ao abrir o seu modelo da Kondado, você verá um pequeno livro ao lado de “Configurações”. Ao clicar neste livro, você acessará a documentação do seu modelo.
![](https://kondado.com.br/blog/wiki/wp-content/uploads/sites/2/2020/11/ximage-2.png.pagespeed.ic.kCmGv6pf_c.png)
Estrutura da documentação
A documentação de um modelo possui 4 seções:
RESUMO
Contém informações básicas e não diretamente editáveis sobre o modelo: URL, Status, Tabela, Destino, Acionadores e cadeia de execução
![](https://kondado.com.br/blog/wiki/wp-content/uploads/sites/2/2020/11/ximage-3-1024x381.png.pagespeed.ic.cSpzcZnjBs.png)
SOBRE
A seção “Sobre” é o um texto livre a ser criado pelos usuários. A sua edição é similar a escrever um documento word (ou google docs).
Para editar a seção sobre, basta clicar no lápis que fica ao lado do título da seção:
![](https://kondado.com.br/blog/wiki/wp-content/uploads/sites/2/2020/11/image-4.png.pagespeed.ce.kYIUFEW_s2.png)
Neste editor, você poderá escrever o que quiser e utilizar as ações disponíveis para formatar o seu texto. Aqui você pode incluir uma descrição do modelo, seu objetivo, publico-alvo, exemplos de uso, etc.
![](https://kondado.com.br/blog/wiki/wp-content/uploads/sites/2/2020/11/ximage-5.png.pagespeed.ic.hcvMNew6RF.png)
Uma vez que você esteja satisfeito com o texto escrito, basta clicar no disquete ao lado do título da seção e o seu texto será salvo.
CAMPOS
Após cada execução de um modelo, a Kondado guarda os campos da tabela gerada. Nesta seção da documentação, você pode fornecer uma descrição para cada campo gerado na sua tabela.
![](https://kondado.com.br/blog/wiki/wp-content/uploads/sites/2/2020/11/ximage-6.png.pagespeed.ic.0F2F-LUJpX.png)
Para editar a descrição de um campo, basta clicar no lápis que aparecerá em cada linha, na coluna “DESCRIÇÃO”
![](https://kondado.com.br/blog/wiki/wp-content/uploads/sites/2/2020/11/ximage-7.png.pagespeed.ic.p0YBYbiSZ1.png)
Uma vez que você esteja satisfeito com a descrição daquele campo, basta clicar no disquete e a descrição será salva
![](https://kondado.com.br/blog/wiki/wp-content/uploads/sites/2/2020/11/ximage-8.png.pagespeed.ic.wdkk9yNQa2.png)
QUERY
Nesta seção, será exibida a query (SQL) do modelo, sem possibilidade de edição
![](https://kondado.com.br/blog/wiki/wp-content/uploads/sites/2/2020/11/ximage-9.png.pagespeed.ic.0y7gCsw9XV.png)