mayo 16, 2009

Code Conventions for the JavaTM Programming Language

hao,

El cholo (amigo de la u) me escribe: "Cholo una pregunta, un lugar donde den tips para programar... Por ejemplo, lo de comentar código. Identificar variables con respecto a su función... cosas así... No tienes un post por ahí a la mano?¡¡?"

Le respondo al cholo: "Uyy cholo me puso a revolcar el historial jeje... yo se que había visto un doc. que contiene unas las convenciones y estándares para programar, de la A a la Z, las mejores practicas al momento de tirar código xD, por supuesto de java, pero aplicable a cualquier otro lenguaje; después de 1 hora de exhaustiva búsqueda me di cuenta de 2 cosas:
  1. Para buscar cosas en el historial con chrome uno se muere de hambre, debería tener una búsqueda avanzada, que filtre por fecha como mínimo. O es que no lo supe utilizar :S
  2. Cuando uno se topa con información importante, que no puede o no quiere leer en ese momento, pero sabe que le va a ser de utilidad, nada mejor que hacerle referencia en algún sitio especifico en donde tenemos cosas interesantes pendientes por revisar.
En fin, "ak ta": Code Conventions for the JavaTM Programming Language

Con esta corto doc. nos trasladamos en el tiempo, en los primeros años de la escuela, cuando la profesora nos decía:
  • 5 pts. menos por no dejar sangría al inicio del párrafo.
  • 5 pts. menos por no colocar mayúscula después del punto.
  • 5 pts. menos por ... eso, eso mismo que recuerdas, xD
Jejeje ya veras..."

Y así fue..., y ahora os comparto esta Rueda.

Este documento contiene las convenciones y estándares que Sun sigue y recomienda que nosotros sigamos. Cubre: los nombres de archivo, organización de los archivos, comentarios, declaraciones, sentencias, espacios en blanco, convenciones de nomenclatura, prácticas de programación e incluye código de ejemplo.

¿Por qué las convenciones de código?
  • El 80% del costo de una pieza de software se destina a mantenimiento. (No creas que todo quedo perfecto a la primera).
  • La mayor parte del software es mantenido, durante toda su vida, por el autor original. (O vas a dejar que otro haga fiesta con tu creación xD).
  • Las convenciones de código ayudan a mejorar la legibilidad de los programas informáticos, lo que permite a los ingenieros comprender el código más rápido y en profundidad. (A menos que tengamos una maquina virtual instalada en nuestro cerebro lista para compilar código ofuscado juju).
  • Si su código fuente es un producto (lo vas a vender o compartir), es necesario asegurarse de que este claro y limpio, como cualquier otro producto que usted desearía.
Este doc. es perfecto para perfeccionar el "estilacho" cuando "tiramos código", pero si algunos de nosotros tiene un pana que se inspira "tirando código ofuscado", como toño y adrián (amigos de la u), nos taca recomendarle el libro completo The Java Language Specification, jeje hechando broma.

El doc. anterior se queda pendejo al lado del libro, dice: If you want to know the precise meaning of the language's constructs, this is the source for you. Uff quien dijo miedo. Bueno muchachos que disfrutenlo.

Que la fuerza este contigo! ;)

¿Porqué los numeros son como son?

hao,

Un número es una entidad abstracta que representa una cantidad (de una magnitud), y su origen se pierde en la noche de los tiempos.

Los usamos a diario, somos inseparables de ellos, pero te has preguntado ¿Porqué los numeros son como son, porqué el 1 es 1, y el 2 es 2,...? :? Tu lo sabes? si la respuesta es afirmativa, ¡Oh, vendita curiosidad! te felicito ;). Pero por lo general este dato curioso escapa de la mayoria (lo digo por experiencia).

Con el tiempo los hemos cambiado para escribirlos de forma curba y suave; segun cuenta la leyenda, los números arábigos son representados por la cantidad de angulos que forman al escribirse.


Curioso??

Que la fuerza este contigo! ;)

¿Cuales son los colores primarios? nop, amarillo, azul y rojo, no son!

hao,

Define color: ...?

El color es la percepción visual generada por señales nerviosas que los fotoreceptores de la retina del ojo envían al cerebro con la captación de determinadas longitudes de onda del espectro electromagnético.
Uff, se quedo sin concepto. xD, Pero bueno la cuestión es, cuales son los colores que se definen como primarios: ...? Aja, Amarillo, Azul y Rojo, esos mismos son los que no son, jeje. Existen 2 grupos de colores primarios:

Por adición, o colores primarios de la luz: Rojo, Verde y Azul. Implica que se emita luz directamente de una fuente de iluminación de algún tipo, por ejemplo televisores y monitores. Combinando estos tres colores con las mismas intensidades, se produce el blanco.


Por sustracción, o colores primarios de la pigmentación: Cían, Magneta y Amarillo. Explica la teoría de la mezcla de pinturas o tintas para crear colores que absorben ciertas longitudes de onda y reflejan otras, por ejemplo la impresora o los creyones sobre una hoja blanca. La sustracción de estos 3 colores produce el blanco.

Ok. Consideremos una manzana "roja". Cuando es vista bajo una luz blanca, parece roja. Pero esto no significa que emita luz roja, que sería el caso una síntesis aditiva. Si lo hiciese, seríamos capaces de verla en la oscuridad. En lugar de eso, absorbe algunas de las longitudes de onda que componen la luz blanca, reflejando solo aquellas que el humano ve como rojas. Los humanos ven la manzana roja debido al funcionamiento particular de su ojo y a la interpretación que hace el cerebro de la información que le llega del ojo.

Curioso??

Que la fuerza este contigo! ;)

Sobre mi blog

hao,

La rueda es una pieza mecánica circular que gira alrededor de un eje y el conocimiento de su origen se pierde en el tiempo.

A menos que queramos regresar a "esos tiempos" es recomendable dedicarle un timebox a echar la buscadita y darle un buen vistazo a lo que nos podría facilitar y acelera el trabajo, aumentar la calidad y reducir nuestro esfuerzo :D.

Podríamos construir nuestro propio y lujoso carro con todos sus juguetes, para que "Meteoro" se sienta como si manejara su "Mach5".

Ojo, no se trata de robarle el trabajo y crédito "Sr. Racer", sino de utilizar lo que el decido poner a disposición de la comunidad, respetando su integridad como dueño de la idea, la experiencia, el componente o, para generalizar y redefinir la palabra: "La Rueda".

Así que, os pongo a su disposición, tropiezos, experiencias y curiosidades con las que me he topado o con las que se han topado otros; Por lo general sobre programación y para ser mas específicos sobre java :D.

Espero que el blog les sea de utilidad, sean libres de comentar y criticar, seré todo oídos.

Que la fuerza este contigo! ;)

Creative Commons License