boas_praticas_de_programacao_shell_script
Diferenças
Aqui você vê as diferenças entre duas revisões dessa página.
Ambos lados da revisão anteriorRevisão anteriorPróxima revisão | Revisão anteriorÚltima revisãoAmbos lados da revisão seguinte | ||
boas_praticas_de_programacao_shell_script [2019/07/31 11:24] – cartola | boas_praticas_de_programacao_shell_script [2019/09/25 09:41] – [Frameworks] cartola | ||
---|---|---|---|
Linha 1: | Linha 1: | ||
+ | ====== Programação Shell Script: boas práticas ====== | ||
Antes veja [[ti_publica: | Antes veja [[ti_publica: | ||
Linha 7: | Linha 8: | ||
Naturalmente algumas dicas aqui provavelmente servirão pra outras linguagens de programação. A medida que eu perceber isso vou tentar marcá-las como " | Naturalmente algumas dicas aqui provavelmente servirão pra outras linguagens de programação. A medida que eu perceber isso vou tentar marcá-las como " | ||
+ | ===== Referências Externas ===== | ||
+ | ==== Gerais ==== | ||
+ | * [[http:// | ||
+ | ==== Frameworks ==== | ||
+ | * [[https:// | ||
+ | * [[http:// | ||
+ | * [[https:// | ||
+ | |||
+ | ==== IDE ==== | ||
+ | |||
+ | IDE é a sigla de Integrated Development Environment, | ||
+ | |||
+ | * Costumo identar com 2 espaços: set tabspace=2 | ||
+ | * Costumo limitar as linhas a 80 colunas:\\ set columns=80\\ set textwidth=80\\ set wrapmargin=8 | ||
+ | * Gosto do [[https:// | ||
======= Documentação ======= | ======= Documentação ======= | ||
Uma etapa bem sedimentada nos conceitos de engenharia de software é a documentação. Já vi muita documentação de sistemas e muito trabalho sendo contratado que exigia a criação de uma. Há uma documentação, | Uma etapa bem sedimentada nos conceitos de engenharia de software é a documentação. Já vi muita documentação de sistemas e muito trabalho sendo contratado que exigia a criação de uma. Há uma documentação, | ||
- | **Comentários - **DICA GERAL** | + | **Comentários - DICA GERAL** |
- | **\\ | + | * **regras de negócio** - um código bem comentado pode conter até as regras de negócio que estão normalmente num documento de especificação. Isso facilita a manutenção atualizada. No momento que a regra for alterada na prática, o programador está ali e pode ver que é necessário alterar o comentário. |
* **lógica** - em outras situações o programador faz uma lógica mais complexa e não a explica em comentários. Isso é muito ruim, tanto para trabalho em equipe quanto para o próprio programador, | * **lógica** - em outras situações o programador faz uma lógica mais complexa e não a explica em comentários. Isso é muito ruim, tanto para trabalho em equipe quanto para o próprio programador, | ||
Linha 21: | Linha 37: | ||
* **nomes de variáveis minúsculos** - é um hábito de muitos programadores Shell o uso de nomes maiúsculos para variáveis. Isso aumenta o risco de acertar o nome de uma variável ambiente, essas sim, tradicionalmente maiúsculas. | * **nomes de variáveis minúsculos** - é um hábito de muitos programadores Shell o uso de nomes maiúsculos para variáveis. Isso aumenta o risco de acertar o nome de uma variável ambiente, essas sim, tradicionalmente maiúsculas. | ||
- | **Cabeçalho - **DICA GERAL** | + | **Cabeçalho - DICA GERAL** \\ Use um cabeçalho padrão nos seus códigos. Um bom cabeçalho pode conter: |
- | **\\Use um cabeçalho padrão nos seus códigos. Um bom cabeçalho pode conter: | + | |
* Descrição geral do que aquele código faz | * Descrição geral do que aquele código faz | ||
* Nome do autor e data de criação | * Nome do autor e data de criação |
boas_praticas_de_programacao_shell_script.txt · Última modificação: 2022/03/25 09:09 por cartola