Primeiros passos

[Daniel Alves Grillo]

Olá pessoal,

Eu gostaria de saber se há alguma norma (Coding Standards) para contribuir com o código.

At.

Daniel

[Carlos Henrique Barriquello]

Olá Daniel,.

oficialmente não temos uma norma de padronização (inclusive esta já seria uma contribuição ao projeto). 

Mas de forma geral, tenta-se seguir as boas práticas de programação tanto quanto possível.  

Se você analisar o código do BRTOS, vai perceber que, em geral, se utiliza notação CamelCase para nomes de funções e variáveis globais, macros são preferencialmente em maiúsculas e a documentação segue o padrão do Doxygen.

At,

Carlos H. Barriquello

--
Você recebeu essa mensagem porque está inscrito no grupo "BRTOS" dos Grupos do Google.
Para cancelar inscrição nesse grupo e parar de receber e-mails dele, envie um e-mail para brtos+un...@googlegroups.com.
Para postar nesse grupo, envie um e-mail para br...@googlegroups.com.
Acesse esse grupo em http://groups.google.com/group/brtos.
Para mais opções, acesse https://groups.google.com/d/optout.

[Daniel Alves Grillo]

Olá Carlos,

Desculpe a demora para responder. O GMail não filtrou este como importante e acabou se perdendo nos inúmeros e-mails que recebo.

Onde eu trabalho eu uso um que "criei" juntando o do Michael Barr (90%) com o do Jack Ganssle (http://www.ganssle.com/misc/fsm.doc) e mais outros que não me lembro agora. Eu gosto muito desses padrões, e acabei me acostumando com eles. E tem várias coisas diferentes do que é usado no BRTOS. Minha preocupação seria fazer alguma contribuição para o código e ficar diferente do padrão, por causa de minhas preferências.

Já que você citou que há interesse em se criar uma norma, eu gostaria de ajudar. Eu tenho conta no GitHub mas ainda não sei usá-lo. Será que teria como a gente concentrar as discussões lá? 

[]'s,

Daniel

[Carlos Henrique Barriquello]

Olá Daniel,

de fato nós também estamos iniciando a utilizar o GitHub para manter o código do BRTOS e, portanto, o aprendizado é conjunto.

Seguindo sua sugestão, abri um "issue" no github para sugestões de regras de padronização (https://github.com/brtos/brtos/issues/1)... então sinta-se à vontade para fazer sugestões...

A idéia é juntar as sugestões para organizar um documento de padronização de código para o BRTOS a ser publicado na Wiki do projeto...

Claro que devido ao "estilo" já usado no código do BRTOS já estar com uma base de código considerável, seria interessante termos sugestões o mais "compatível" possível com o estilo atual...

Outro ponto interessante é não termos muitas regras, pois embora o estilo seja importante para ter uma boa qualidade de código, gostaríamos de não ter muitas barreiras para quem quiser contribuir com o projeto e também não queremos "amedrontar" ninguém que tenha interesse em contribuir... 

Abraço,

Carlos