Minimalism

Minimalism is fine too.

Minimalism Extremist

There is no need to cut off an arm just because you have two. Do you understand?

No necesita cortarse un brazo solo por el hecho de tener dos. ¿Entiende?

Repeat yourself

Sometimes you need to search the meaning of new things. So DO NOT add new words, try to use a minimal dictionary. It's impossible to not repeat. Less dependency is a good practice.

Left to Right

Attempt at translating to English

To make your code easy to understand, please, please, please use a left-to-right style of reference. For example, in a function name you should write the words in this order: Left: group, namespace, property, or class Right: action or event

This serves to separate two concepts, dealing with a limitation of human language.

To be more clear, look at this example code:

Original Spanish

Para aplicar una lógica de facil entendimiento, se ruega utilizar el estilo de referencia izquierda a derecha. Esto quiere decir que, por ejemplo, en una funcion se debe escribir el orden de aproximación: Izquierda: marco en el que se agrupa, namespace, propiedades o clase. Derecha: nombre de la accion, o evento.

Esto sirve para separar dos conceptos ante una limitación del lenguaje humano.

Para ser más claros, vea este codigo de ejemplo.

void myclass_set_property(myclass_t* self, char* name); // BAD
void myclass_property_set(myclass_t* self, char* name) // GOOD
void myclass_window_set_title(myclass_t* self, char* name) // BAD
void myclass_window_title_set(myclass_t* self, char* name) // GOOD
char* myclass_window_title_get(myclass_t* self) // GOOD

Attempt at translating to English

This gives an idea of the object hierarchy.

Original Spanish

Esto da una idea de jerarquia orientada a objeto.

myclass
 |_ property
      |_ set
 |_ window
      |_ title
           |_ set
           |_ get
minimalism.txt · Last modified: 2011/12/21 22:16 by steve zesch
 
Recent changes RSS feed Driven by DokuWiki
Hosted by First Colo