Caelum Stella - utilidades para o desenvolvedor brasileiro open source!

É mesmo, nem reparei que mudaram isso. Podia mostrar a documentação do parâmetro junto: https://bugs.eclipse.org/bugs/show_bug.cgi?id=233528

Fabio Kung wrote:

renato3110 wrote:Não entendo por que o Eclipse não mostra o nome das variáveis no auto complete, isso ajudaria muito...

como não? aqui mostra normal.

O Eclipse (ou IntelliJ, ou qqer outra IDE que nao faca milagre ou use o ParaNamer) so consegue mostrar os nomes de argumentos quando vc linka o JavaDoc da lib que esta usando no projeto.

Aqui mostrou o nome mesmo sem Javadoc

Paulo Silveira wrote:proximo passo é seguir uma ideia que o misterm falou e que o Fabio Kung quis fazer desde o comeco: criar entidades para CPF, CNPJ, IE, etc. Nao fizemos isso no comeco porque nao queriamos atrapalhar o model da pessoa. vamos deixar as duas opcoes, e criar user types para o hibernate e converters para JSF.

JSF Show de BOLA PAULO

Parabéns, já começamos os testes aqui

This message was edited 1 time. Last update was at 26/05/2008 12:37:56

renato3110 wrote:Aqui mostrou o nome mesmo sem Javadoc

Provavelmente porque o fonte está visível para o Eclipse, se não ele mostraria os velhos arg0, arg1...

Ah! E parabéns para o pessoal da Caelum!

Só enxendo o saco (mas particularmente n gosto qdo vejo codigo assim):

"BoletoGenerator", "withData"...
Nao seria melhor escolher 1 lingua, ao inves de mesclar as 2? algo como "GeradorDeBoleto" ou "withDate"?

No mais... parabéns pelo projeto... muito util.

Forum Spammer Membro desde: 22/03/2005 20:57:48 Mensagens: 1699 Offline

fabiocsi wrote:Só enxendo o saco (mas particularmente n gosto qdo vejo codigo assim):

"BoletoGenerator", "withData"...
Nao seria melhor escolher 1 lingua, ao inves de mesclar as 2? algo como "GeradorDeBoleto" ou "withDate"?

++

É... fica a impressão que o autor não sabe inglês ou não sabe Portugues... fora que quem usa a API de memoria
tem um problema para saber quando é usando ingles e quando não. (withData ou comDate ?)

Olá

fabiocsi wrote:Só enxendo o saco (mas particularmente n gosto qdo vejo codigo assim):

"BoletoGenerator", "withData"...
Nao seria melhor escolher 1 lingua, ao inves de mesclar as 2? algo como "GeradorDeBoleto" ou "withDate"?

Ficou meio esquisito mesmo. E agora, o que sugeriria depois que a API veio a público? Refatorar? Lançar nova versão com wrappers para os nomes?

[]s
Luca

JavaTeenager Membro desde: 11/02/2008 10:03:12 Mensagens: 158 Offline

Muito legal!

Certamente será muito util já to fazendo a propagando para meus amigos desenvolvedores.

Parabéns.

Oi gente,

A discussão sobre inglês vs português é sim muito relevante. Internamente, discutimos bastante mesmo sobre isso, e sempre há controvérsia. Cada um sempre tem uma opinião diferente a respeito.

Se fizermos totalmente em inglês, como ficariam os termos do domínio (que são específicos do Brasil)? Se fizermos tudo em português, como ficam os getters? E os termos técnicos que todo mundo conhece em inglês? Se escolhessemos pelo pt-BR puro, no mínimo misturamos, já que as próprias palavras reservadas do Java são em inglês. Não há como não misturar.

Dado tudo isso, infelizmente não é possível agradar a todos e tomamos uma decisão: tudo que tem a ver com o domínio vai em pt-BR, incluindo também toda a documentação (javadoc + site). Todo o resto em inglês.

Convenhamos que isso é importante mas não é o maior de todos os problemas. Foi apenas a convenção que adotamos. Mesmo se alguém não conseguir engolir de forma alguma os nomes, pode sem problemas criar uma camada a mais de adapters com todos os métodos em inglês ou português.

Nos comentários do post no blog, o Guilherme Chapiewski fez o mesmo comentário. Vale a pena dar uma olhada e comentar por lá.

Para não ter problemas de memória e não precisar lembrar se é withData ou comDate na hora que estiver usando a API, basta entender a convenção. Ou ainda usar o auto-complete da sua ide. Foi uma falha nossa não ter deixado isso claro na documentação. Obrigado Sérgio!

Virtual Machine Man Membro desde: 30/07/2006 16:09:55 Mensagens: 878 Offline

Fabio Kung wrote:Oi gente,

A discussão sobre inglês vs português é sim muito relevante. Internamente, discutimos bastante mesmo sobre isso, e sempre há controvérsia. Cada um sempre tem uma opinião diferente a respeito.

Se fizermos totalmente em inglês, como ficariam os termos do domínio (que são específicos do Brasil)? Se fizermos tudo em português, como ficam os getters? E os termos técnicos que todo mundo conhece em inglês? Se escolhessemos pelo pt-BR puro, no mínimo misturamos, já que as próprias palavras reservadas do Java são em inglês. Não há como não misturar.

Dado tudo isso, infelizmente não é possível agradar a todos e tomamos uma decisão: tudo que tem a ver com o domínio vai em pt-BR, incluindo também toda a documentação (javadoc + site). Todo o resto em inglês.

Convenhamos que isso é importante mas não é o maior de todos os problemas. Foi apenas a convenção que adotamos. Mesmo se alguém não conseguir engolir de forma alguma os nomes, pode sem problemas criar uma camada a mais de adapters com todos os métodos em inglês ou português.

Nos comentários do post no blog, o Guilherme Chapiewski fez o mesmo comentário. Vale a pena dar uma olhada e comentar por lá.

Para não ter problemas de memória e não precisar lembrar se é withData ou comDate na hora que estiver usando a API, basta entender a convenção. Ou ainda usar o auto-complete da sua ide. Foi uma falha nossa não ter deixado isso claro na documentação. Obrigado Sérgio!

Pelo que vi nos projetos que passei, essa é a solução mais adotada mesmo.

Tentar traduzir tudo pra inglês fica tosco com algumas palavras. Ou alguém sabe como traduzir CARTEIRA para inglês? E colocar pegarXXX seria horrível.

PS: Carteira no sentido bancário e não carteira que você põe no bolso.

This message was edited 1 time. Last update was at 26/05/2008 21:43:05

sergiotaborda wrote:É... fica a impressão que o autor não sabe inglês ou não sabe Portugues... fora que quem usa a API de memoria
tem um problema para saber quando é usando ingles e quando não. (withData ou comDate ?)

Opa! Parece que o autor nao sabe ingles nem portugues assim como parece que voce nao conhece alguns recursos magicos do Eclipse Sergio!!! Deixa eu apresenta-los:

Sergio, esse é o Control-Espaço
Control-Espaço, esse é o Sergio!

Esse tipo de API nao é aquela que a gente decora com é java.util e java.io.... control espaco nela!

Brincadeiras a parte, foi realmente uma decisao dificil. Teriamos interface Bank e ai BancoDoBrasil implements Bank.... E esse problema do with é o MESMO que temos com getters e setters.... nao ficamos satisfeitos com nenhuma das abordagens, entao pegamos uma das duas. Se tiver uma sugestao melhor, eh só escrever!

HelloWorld Membro desde: 27/04/2007 04:46:58 Mensagens: 12 Offline

Pessoal,

essa questão de dos termos da API, é de certa forma complicada.

Acredito que mistura do português com o inglês na API uniu o melhor dos dois mundos.

Não podemos deixar de tratar os termos do domínio na sua linguagem natural. Neste ponto acredito que todos concordamos.

Por outro lado, já estamos acostumados as termos em inglês get, set, with, assert, isValid, Message , etc...
Sinceramente eu não conheço ninguém que prefira utilizar estes termos em português quando está escrevendo código.

Após o reconhecimento inicial da convenção da API, provavelmente a maioria dos desenvolvedores não terá dificuldade nem para encontrar os termos específicos do dominio (como Carteira,CEP,CNPJ,etc..), nem para utilizar os termos em inglês.

Bem, essa é a minha opinião sobre a API. Apesar da estranheza inicial, a decisão de misturar os termos em português e em inglês foi acertada.

Valorizo muito as críticas, principalmente as construtivas.
É exagero dizer que o autor não sabe inglês ou não sabe português.

Para quem usa a API de forma intuitiva, não terá dificuldade em escolher "withData" ao invés de "comDate", seguindo a convenção.

"Que ninguém se engane, só se consegue a simplicidade através de muito trabalho." - Clarice Lispector

fabiocsi wrote:Só enxendo o saco (mas particularmente n gosto qdo vejo codigo assim):

"BoletoGenerator", "withData"...
Nao seria melhor escolher 1 lingua, ao inves de mesclar as 2? algo como "GeradorDeBoleto" ou "withDate"?

No mais... parabéns pelo projeto... muito util.

É como se mesclasse o nome da entidade + nome do padrão.

Como Factory, Generator, Model, etc...

Mas concordo contigo que fica um pouco "chatinho" de observar assim.

What is classpath? Membro desde: 29/08/2007 10:42:05 Mensagens: 8 Offline

Críticas devem ser aceitas da melhor maneira, porem não sei se é tão relevante a tal crítica feita sobre os dois idiomas mesclados no código, mas sei que é relevante o sucesso que o caelum stella está fazendo =]...