R help es - Nov 2010 - Una guía de estilo para programar en R...

Hola,

He seguido con interés el mensaje de Carlos sobre la guía de estilo para
programar en R aparecida en Google y las reacciones que ha generado. 

 

En líneas generales creo que la guía Google es bastante floja, estoy de
acuerdo con la mayoría de comentarios iniciales de Carlos y en particular
con el hecho de que no trata en absoluto (ni lógicamente promueve) la
creación de packages. Otro aspecto débil de esta guía es la falta casi
absoluta de motivación de sus propuestas. Creo que es muy superior otra
propuesta más antigua, citada en la propia guía de Google:
http://www.maths.lth.se/help/R/RCC/.

 

Algunos puntos concretos sobre los que quisiera opinar son:

a) Nombres de variables: promueve el formato “palabra.otrapalabra” y
desaconseja “palabraOtrapalabra”. Como es habitual en esta guía, no explica
las razones. En mi opinión ambas estrategias deberían ser perfectamente
admisibles, la primera dada su gran “tradición R” y la segunda dadp que
también es muy común en otros lenguajes (y también en R). Ambas son
altamente expresivas, aunque yo prefiero la segunda.

b) Nombres de funciones: no encuentro muy razonable que tengan que empezar
por una letra mayúscula. Puede ser simplemente una cuestión de gustos, pero,
por ejemplo, reservaría el consejo para los nombres de clases, especialmente
las clases S4.

c) Constantes: “kNombre” creo que es de risa como criterio general, no niego
que pueda ser útil a nivel de un programa concreto o de algún grupo de
trabajo.

d) Clases S4: desaconseja su uso, al menos en la tabla de contenido de la
guía. Al leer el apartado correspondiente se puede ver que el tema está algo
más matizado. En mi opinión el sistema de clases S4 tiene sus puntos fuertes
y sus puntos débiles, como casi todo, pero creo que es francamente mejor
para proyectos de una cierta envergadura, donde su mayor complejidad
representa una inversión que vale la pena. Yo lo empleo regularmente y estoy
satisfecho. De lo que se trata es de saber emplear R de forma razonable, no
de matar moscas a cañonazos. En el caso de considerar que el esfuerzo de
aprendizaje de S4 pueda valer la pena, aconsejo una visita a esta página
Web: http://christophe.genolini.free.fr/. 

 

Tener una guía de estilo R puede ser útil siempre que se emplee
razonablemente y con un cierto espíritu crítico. Por ejemplo supeditándola a
criterios más específicos que hayan funcionado bien dentro de un grupo de
trabajo. Me parece interesante tratar el tema e incluso intentar tener una
guía de nuestra comunidad, aunque no partiría de la propuesta de Google,
mejor sugiero la que os comento más arriba como punto de partida.

 

Saludos cordiales,

Jordi Ocaña Rebull

Departament d''Estadística

Universitat de Barcelona

 


	[[alternative HTML version deleted]]

Hola, ¿qué tal?

Gracias a todos por los comentarios de este hilo.

Lo que parece claro es:

1) Que no existe una guía de estilo "urbi et orbi", no obstante lo
cual,

2) es importante que grupos locales de desarrolladores se atengan a una 
debidamente explicitada.

Una cosa que echo de menos en ésta (la de Google) y otras guías de 
estilo que he visto es que no se toman la molestia de distinguir 
explícitamente entre:

1) Las normas que responden a motivos objetivos (p.e., usar siempre 
espacios (¡o tabuladores!) a la hora de indentar (¡pero nunca 
mezclarlos!)), que debieran razonarse en algún punto.

2) Las normas que responden únicamente a una cuestión de convención 
(p.e., indentar con N espacios).

Lo más parecido a una guía "urbi et orbi" sería una en la que las
normas
de tipo (1) fuesen fijas y las distintas alternativas para las normas de 
tipo (2) apareciesen enumeradas para que los distintos grupos de 
desarrolladores pudiesen decantarse por alguna (y seguirlas de ahí en 
adelante a rajatabla).

Un saludo,

Carlos J. Gil Bellosta
http://www.datanalytics.com


On 11/05/2010 07:43 PM, Jordi Ocaña wrote:
> Hola,
>
> He seguido con interés el mensaje de Carlos sobre la guía de estilo para
> programar en R aparecida en Google y las reacciones que ha generado.
>
>
>
> En líneas generales creo que la guía Google es bastante floja, estoy de
> acuerdo con la mayoría de comentarios iniciales de Carlos y en particular
> con el hecho de que no trata en absoluto (ni lógicamente promueve) la
> creación de packages. Otro aspecto débil de esta guía es la falta casi
> absoluta de motivación de sus propuestas. Creo que es muy superior otra
> propuesta más antigua, citada en la propia guía de Google:
> http://www.maths.lth.se/help/R/RCC/.
>
>
>
> Algunos puntos concretos sobre los que quisiera opinar son:
>
> a) Nombres de variables: promueve el formato ?palabra.otrapalabra? y
> desaconseja ?palabraOtrapalabra?. Como es habitual en esta guía, no explica
> las razones. En mi opinión ambas estrategias deberían ser perfectamente
> admisibles, la primera dada su gran ?tradición R? y la segunda dadp que
> también es muy común en otros lenguajes (y también en R). Ambas son
> altamente expresivas, aunque yo prefiero la segunda.
>
> b) Nombres de funciones: no encuentro muy razonable que tengan que empezar
> por una letra mayúscula. Puede ser simplemente una cuestión de gustos,
pero,
> por ejemplo, reservaría el consejo para los nombres de clases,
especialmente
> las clases S4.
>
> c) Constantes: ?kNombre? creo que es de risa como criterio general, no
niego
> que pueda ser útil a nivel de un programa concreto o de algún grupo de
> trabajo.
>
> d) Clases S4: desaconseja su uso, al menos en la tabla de contenido de la
> guía. Al leer el apartado correspondiente se puede ver que el tema está
algo
> más matizado. En mi opinión el sistema de clases S4 tiene sus puntos
fuertes
> y sus puntos débiles, como casi todo, pero creo que es francamente mejor
> para proyectos de una cierta envergadura, donde su mayor complejidad
> representa una inversión que vale la pena. Yo lo empleo regularmente y
estoy
> satisfecho. De lo que se trata es de saber emplear R de forma razonable, no
> de matar moscas a cañonazos. En el caso de considerar que el esfuerzo de
> aprendizaje de S4 pueda valer la pena, aconsejo una visita a esta página
> Web: http://christophe.genolini.free.fr/.
>
>
>
> Tener una guía de estilo R puede ser útil siempre que se emplee
> razonablemente y con un cierto espíritu crítico. Por ejemplo supeditándola
a
> criterios más específicos que hayan funcionado bien dentro de un grupo de
> trabajo. Me parece interesante tratar el tema e incluso intentar tener una
> guía de nuestra comunidad, aunque no partiría de la propuesta de Google,
> mejor sugiero la que os comento más arriba como punto de partida.
>
>
>
> Saludos cordiales,
>
> Jordi Ocaña Rebull
>
> Departament d'Estadística
>
> Universitat de Barcelona
>
>
>
>
> 	[[alternative HTML version deleted]]
>
>
>
>
> _______________________________________________
> R-help-es mailing list
> R-help-es en r-project.org
> https://stat.ethz.ch/mailman/listinfo/r-help-es