update pt-br norme to v4 (#430)

* update pt-br norme to v4 * Update pdf/pt_br.norm.tex Co-authored-by: NiumXp <[email protected]> * Update pdf/pt_br.norm.tex Co-authored-by: NiumXp <[email protected]> * Update pdf/pt_br.norm.tex Co-authored-by: NiumXp <[email protected]> * Update pdf/pt_br.norm.tex Co-authored-by: NiumXp <[email protected]> * Update pdf/pt_br.norm.tex Co-authored-by: NiumXp <[email protected]> * Update pdf/pt_br.norm.tex Co-authored-by: NiumXp <[email protected]> * Update pdf/pt_br.norm.tex Co-authored-by: NiumXp <[email protected]> * Update pdf/pt_br.norm.tex Co-authored-by: NiumXp <[email protected]> --------- Co-authored-by: NiumXp <[email protected]>
42School · Sep 5, 2023 · 010d8d0 · 010d8d0
1 parent 3fdbb83
commit 010d8d0
Showing 1 changed file with 17 additions and 15 deletions.
diff --git a/pdf/pt_br.norm.tex b/pdf/pt_br.norm.tex
@@ -1,5 +1,4 @@
 \documentclass{42-pt}
-\newcommand\qdsh{\texttt{42sh}}
 
 
 
@@ -11,11 +10,11 @@
 
 \begin{document}
 \title{A Norma}
-\subtitle{Versão 3}
+\subtitle{Versão 4}
 
 \summary
 {
-    Este documento descreve o padrão aplicável (norma) na 42. Um padrão de
+    Este documento descreve o padrão aplicável (Norma) na 42. Um padrão de
 	programação define um conjunto de regras a seguir ao escrever um código.
     A norma aplica-se a todos os projetos C dentro do círculo interno por padrão, e
     para qualquer projeto onde é especificado.
@@ -34,7 +33,7 @@
 %******************************************************************************%
 \chapter{Introdução}
 
-    A norma é em Python e código aberto.\\
+    A \texttt{norminette} é em Python e código aberto.\\
     Seu repositório está disponível em https://github.com/42school/norminette. \\
     Pull requests, sugestões e indicação de bugs são bem-vindos!
 
@@ -112,10 +111,10 @@ \chapter{Introdução}
 
 %******************************************************************************%
 %                                                                              %
-%                                  A norma                                     %
+%                                  A Norma                                     %
 %                                                                              %
 %******************************************************************************%
-\chapter{A norma}
+\chapter{A Norma}
 
 
 %******************************************************************************%
@@ -157,9 +156,7 @@ \chapter{A norma}
                 arquivos ou diretórios) devem ter os
                 nomes mais explícitos ou mais mnemônicos possíveis.
 
-            \item Usando uma variável global em um projeto onde não é
-                explicitamente permitido é um erro de norma, exceto onde é
-                obrigatório (manuseio de sinais, por exemplo).
+            \item Usar variáveis globais é proibido e considerado um erro de norma, há menos que seja explicitamente permitido o uso no projeto.
 
             \item O arquivo deve compilar. Um arquivo que não compila não é esperado
                 que passe na norma.
@@ -216,7 +213,7 @@ \chapter{A norma}
                 \item Os asteriscos que vão com ponteiros devem estar juntos aos
                   nomes das variáveis.
 
-                \item Uma única declaração variável por linha.
+                \item Uma única declaração de variável por linha.
 
                 \item Declaração e uma inicialização não podem estar
                   na mesma linha, exceto para variáveis globais (quando permitido),
@@ -236,7 +233,8 @@ \chapter{A norma}
                   Os operadores devem estar no início de uma linha.
 
                 \item Estruturas de controle (if, while ...) devem ter chaves,
-                a menos que contenham uma única linha ou uma única condição.
+                a menos que contenham uma única linha.
+                \item Funções seguidas de chaves, declaradores ou estruturas de controle devem ser precedidas e seguidas de uma nova linha.
 
             \end{itemize}
 
@@ -373,7 +371,7 @@ \chapter{A norma}
 %                                 O Header da 42                               %
 %******************************************************************************%
 
-   \section{O Header da 42}
+   \section{O Header da 42 - vulgo começar um arquivo com estilo}
 
         \begin{itemize}
 
@@ -385,7 +383,7 @@ \chapter{A norma}
 
         \item O header da 42 deve conter informações atualizadas, incluindo o
           criador com login e email, a data de criação e a data da atualização
-          mais recente.
+          mais recente. Cada vez que o arquivo for salvo em disco, a informação deve ser atualizada automaticamente.
 
         \end{itemize}
         \newpage
@@ -408,7 +406,7 @@ \chapter{A norma}
             \item Nomes de macro devem ser todos maiúsculos (uppercase).
             \item Você deve recuar caracteres que seguirem \#if, \#ifdef
                 or \#ifndef.
-
+            \item Instruções de pré-processamento são proibidas fora do escopo global.
         \end{itemize}
         \newpage
 
@@ -463,10 +461,14 @@ \chapter{A norma}
             \item Seus comentários devem estar em inglês. E eles devem ser
                 úteis.
 
-            \item Um comentário não pode ser usado para justificar uma função 
+            \item Um comentário não pode ser usado para justificar declarações ou uma função 
 				mal feita.
 
         \end{itemize}
+	\warn{
+		Uma declaração ou função mal feita normalmente vem com nomes não inteligíveis como f1, f2, etc. para as funções e, a, b, i, etc. para declarações.
+		Uma função cujo objetivo é evitar ou burlar a norma, sem um único propósito lógico, também é considerado uma função mal feita.
+		Por favor, lembre-se de que é desejável ter funções limpas e legíveis que realizem uma clara e simples tarefa. Evite qualquer técnica de ofuscação de código como \emph{one-liner}.
         \newpage