mirrors/electron
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
electron/docs-translations/es/development/coding-style.md
Kevin Sawicki 102f7e8e33 Update docs for new org
2016-04-04 12:05:53 -07:00

1.8 KiB
Raw Blame History

Guía de estilo de código

Esta es la guía de estilo de código para Electron.

C++ y Python

Para C++ y Python, nosotros seguimos la guía de estilo de Chromium. Además hay un script script/cpplint.py para verificar si todos los archivos siguen el estilo.

La versión de Python que estamos usando ahora es Python 2.7.

El código C++ usa muchas abstracciones y tipos de Chromium, por eso se recomienda familiarizarse con ellos. Un buen lugar para iniciar es el documento de Chromium sobre Abstracciones importantes y estructras de datos. El documento menciona algunos tipos especiales, tipos por alcance (que automaticamente liberan su memoria cuando salen de su alcance), mecanismos de registro de eventos, etcétera.

CoffeeScript

Para CoffeeScript, nosotros seguimos la guía de estilo de Github y también las siguientes reglas:

  • Los archivos NO deberían terminar con una nueva línea, por que se busca seguir los estilos que usa Google.
  • Los nombres de los archivos debén estar concatenados con - en vez de _, por ejemplo nombre-de-archivo.coffee en vez de nombre_de_archivo.coffee, esto es por que en github/atom los nombres de los módulos usualmente estan en la forma nombre-de-modulo. Esta regla aplica únicamente a los archivos .coffee.

Nombres de las API

Al crear una nueva API, nosotros deberíamos preferir usar metodos get y set en vez de usar el estilo de jQuery que utiliza una sola función. Por ejemplo, se prefiere .getText() y .setText() por sobre .text([text]). Hay una discusión sobre esto.