Update autodocAI authored by Ramicés dos Santos Silva's avatar Ramicés dos Santos Silva
...@@ -2,13 +2,13 @@ ...@@ -2,13 +2,13 @@
## Visão Geral ## Visão Geral
Este documento descreve o procedimento para a geração automatizada de documentação utilizando a ferramenta bito.ai, com ênfase no uso de CLI e scripts de automação. A ferramenta bito.ai permite a criação de documentação técnica de forma eficiente e padronizada, facilitando a manutenção e a atualização contínua dos documentos. Este documento descreve o procedimento para a geração automatizada de documentação utilizando a ferramenta bito.ai, com ênfase no uso de CLI e scripts de automação. A ferramenta permite a criação de documentação técnica de forma eficiente e padronizada, facilitando a manutenção e a atualização contínua dos documentos utilizando Inteligência Artificial Generativa.
## Requisitos ## Requisitos
- **bito.ai**: A ferramenta bito.ai deve estar instalada e configurada no ambiente de desenvolvimento. - **bito.ai**: A ferramenta bito.ai deve estar instalada e configurada no ambiente de desenvolvimento.
- **CLI (Command Line Interface)**: O CLI deve estar acessível para execução de comandos. - **CLI (Command Line Interface)**: O CLI deve estar acessível para execução de comandos.
- **Scripts de Automação**: Scripts devem estar prontos e configurados para a execução automatizada. - **Scripts de Automação**: Scripts utilizados para automação da geração da documentação.
## Instalação e Configuração ## Instalação e Configuração
...@@ -17,11 +17,12 @@ Este documento descreve o procedimento para a geração automatizada de document ...@@ -17,11 +17,12 @@ Este documento descreve o procedimento para a geração automatizada de document
1. **Download e Instalação**: 1. **Download e Instalação**:
- Baixe o instalador apropriado para o seu sistema operacional a partir do site oficial do bito.ai. - Baixe o instalador apropriado para o seu sistema operacional a partir do site oficial do bito.ai.
- Execute o instalador e siga as instruções na tela para concluir a instalação. - Execute o instalador e siga as instruções na tela para concluir a instalação.
- Para geração da documentação utilizou-se sistema operacional Linux Ubuntu por questões de facilidade no aproveitamento de alguns scripts de automação já disponiblizados pela comunidade.
2. **Configuração Inicial**: 2. **Configuração Inicial**:
- Após a instalação, configure o bito.ai com suas credenciais e preferências pessoais. - Após a instalação, configure o bito.ai com suas credenciais e preferências pessoais.
- Execute o comando de configuração inicial: - Execute o comando de configuração inicial:
```bash
```shell
bito config --setup bito config --setup
``` ```
...@@ -30,13 +31,14 @@ Este documento descreve o procedimento para a geração automatizada de document ...@@ -30,13 +31,14 @@ Este documento descreve o procedimento para a geração automatizada de document
1. **Instalação do CLI**: 1. **Instalação do CLI**:
- Certifique-se de que o CLI está instalado e disponível no PATH do seu sistema. - Certifique-se de que o CLI está instalado e disponível no PATH do seu sistema.
- Verifique a instalação com o comando: - Verifique a instalação com o comando:
```bash
```shell
bito --version bito --version
``` ```
2. **Configuração do CLI**: 2. **Configuração do CLI**:
- Configure o CLI para se conectar ao bito.ai com suas credenciais: - Configure o CLI para se conectar ao bito.ai com suas credenciais:
```bash
```shell
bito configure --auth bito configure --auth
``` ```
...@@ -46,7 +48,7 @@ Este documento descreve o procedimento para a geração automatizada de document ...@@ -46,7 +48,7 @@ Este documento descreve o procedimento para a geração automatizada de document
Os scripts de automação devem seguir uma estrutura padrão para garantir a consistência na geração de documentação. Um exemplo básico de script pode ser: Os scripts de automação devem seguir uma estrutura padrão para garantir a consistência na geração de documentação. Um exemplo básico de script pode ser:
```bash ```shell
#!/bin/bash #!/bin/bash
# Script de Geração de Documentação # Script de Geração de Documentação
...@@ -60,3 +62,4 @@ CONFIG_FILE="/caminho/para/configuracao.json" ...@@ -60,3 +62,4 @@ CONFIG_FILE="/caminho/para/configuracao.json"
bito generate --config $CONFIG_FILE --output $OUTPUT_PATH bito generate --config $CONFIG_FILE --output $OUTPUT_PATH
echo "Documentação gerada com sucesso!" echo "Documentação gerada com sucesso!"
```
\ No newline at end of file