Contributing

README.md

@@ -7,22 +7,68 @@ Angular-es es la traducción oficial de Angular.io
 Este sitio incluye también enlaces a otros recursos útiles de angular incluyendo
 Angular 2, Angular 1, Angular Material y AngularFire.
 
-## Problemas
+## Problemas (issues)
 
-Por favor crea **issues en Guithub _sólo_ referentes a la Guía del Desarrollador, a las Recetas y/o de ejemplos de código** en el
-repositorio [Angular.io](https://github.com/angular/angular.io/issues) de github.
+Por favor crea **issues en Github referentes al contenido de la guía y/o de ejemplos de código** en el
+repositorio de [Angular.io](https://github.com/angular/angular.io/issues).
 
-**Problemas con la API de Angular, correcciones del cheatsheet, peticiones de funcionalidad, informes de defectos, y preguntas técnicas** referentes a Angular en si,
-pertenecen al repositorio de [**código fuente de angular**](https://github.com/angular/angular/issues) de github.
-No podemos manejar esos tipos de temas aquí y le pedimos que vuelva a publicarlos en el repositorio de angular.
+**Problemas con la API de Angular, correcciones del cheatsheet, peticiones de
+funcionalidad, informes de defectos, y preguntas técnicas** referentes a
+Angular en si, pertenecen al repositorio de [**código fuente de
+angular**](https://github.com/angular/angular/issues).
+No podemos manejar esos tipos de temas aquí y le pedimos que vuelva a
+publicarlos en el repositorio de Angular.
 
-Por último, para problemas con la localización al Español de esta documentación, por favor abra un issue en el repositorio de [angular-es](https://github.com/angular/angular-es)
+Por último, para problemas con la localización al Español de esta
+documentación, por favor abra issues en el repositorio de
+[angular-es](https://github.com/angular/angular-es).
 
 ## Cómo puedes ayudar
 
-Crear issues en Github es útil, pero ¡**pull requests** que mejoren la documentación son aun mejores!
+Crear issues en Github es útil, pero ¡**pull requests** que mejoren la documentación son aún mejores!
+
+Aprende como [contribuir a Angular](https://github.com/angular/angular.js/blob/master/CONTRIBUTING.md).
+
+### Contribuir a angular-es
+
+¡Contribuir al website de Angular-es es muy sencillo!
+
+* Escoja un
+[issue](https://github.com/angular/angular-es/issues/38) que no esté asignada a
+otra persona.
+* Encuentre el archivo correspondiente:
+  * Los archivos con el contenido de la página se encuentran en la carpeta `public`.
+  * Los elementos comunes de la página, ej el encabezado, se encuentran en la carpeta
+  `public/_includes/`.
+  * Para la documentación mire la carpeta `public/docs/`; la documentación está disponible
+  para JavaScript, Dart y Typescript, los archivos de cada se encuentran en sus respectivas
+  carpetas `js/latest/`, `dart/latest/` y `ts/latest/`.
+  * Los archivos de css, JavaScript e imagenes se encuentran en la carpeta `public/resources/`.
+* Para hacer cambios:
+  * La mayoría de las secciones y páginas están construidas utilizando [jade](http://learnjade.com/).
+  * `Show English`, la página usa un script para permitir ver el inglés original en que la traducción está basada. Para que
+el código funcione correctamente debe agregar el contenido traducido debajo del inglés original, de esta forma:
+
+```jade
+.l-main-section
+  h2 Angular Projects
+  h2 Proyectos de Angular
+
+  p We'd love for you to contribute to our source code and to make Angular projects even better.
+  p Nos encantaría que contribuya a nuestro código fuente y hacer hacer los proyectos de Angular aún mejores.
+```
+* Guía de estilo:
+  * La guía de estilo aún está en desarrollo, encuentre más información en el
+  [issue correspondiente](https://github.com/angular/angular-es/issues/38).
+  * Utilice lenguaje formal.
+  * Algunas palabras que no tienen equivalente en español claro, o que los desarrolladores usan coloquialmente
+  en inglés pueden dejarse así; por ejemplo, `binding`.
+* Integrando los cambios:
+  * [Copia](https://help.github.com/articles/fork-a-repo/) el repositorio de [angular-es](https://github.com/angular/angular-es)
+  y haga las modificaciones en una [rama](https://git-scm.com/book/es/v1/Ramificaciones-en-Git-Procedimientos-b%C3%A1sicos-para-ramificar-y-fusionar) en su copia.
+  * Empuja los cambios a github y crea un pull request.
+  * Aprenda más sobre como contribuir en github [aquí](https://guides.github.com/activities/contributing-to-open-source/).
 
-Aprende como [contribuir a Angular.io](https://github.com/angular/angular.js/blob/master/CONTRIBUTING.md).
 > **IMPORTANTE**: _NO_ haga cambios a los ficheros cacheados de `public/docs_ts/_cache`. Esos ficheros serán actualizados aparte.
 
 ## Configuración para desarrollo
@@ -36,7 +82,7 @@ si no, instala [nvm](https://github.com/creationix/nvm) para conseguir node en t
 3. Clone este repositorio y el [repositorio de código fuente de angular](https://github.com/angular/angular), y el [repositorio de código fuente de dart-lang/angular 2](https://github.com/dart-lang/angular2) en el mismo directorio.
 El repositorio de angular tiene que llamarse **angular** y el de dart **angular-dart**.
 
-4. cd dentro del directorio raiz `angular.io/`
+4. cd dentro del directorio raiz `angular.io`
 
 5. Instale los paquetes locales del sitio ejecutando el comando `npm install`
 > Si está ejecutando node v.5+, probablemente deba reconstruir `node-sass` en un paso a parte: `npm rebuild node-sass`
@@ -47,7 +93,7 @@ El repositorio de angular tiene que llamarse **angular** y el de dart **angular-
 Todo el contenido de documentación está escrito en Jade, el cual tiene [su propia sintaxis](http://jade-lang.com/reference/).
 Hay que tener en cuenta las estrictas exigencias de formato de texto impuestas por Jade.
 Recomendamos encarecidamente ejecutar uno de los comandos `serve-and-sync` de gulp [descritos debajo](#serve-and-sync),
-mientras se edita contenido para poder ver el efecto de los cambios *mientras se teclea*. 
+mientras se edita contenido para poder ver el efecto de los cambios *mientras se teclea*.
 
 La documentación se basa en estilos y mixins específicos.
 Aprenda acerca de ellos en la [guía de estilo de documentación](https://angular.io/docs/ts/latest/styleguide.html).
@@ -60,7 +106,7 @@ Por ejemplo, todos los documentos de TypeScript están en `public/docs/ts/latest
 - `public/docs/ts/latest/tutorial/toh-pt5.jade`
 
 ### Servidor local sincronizado y recarga del navegador
-1. cd dentro del directorio raiz `angular.io/`
+1. cd dentro del directorio raiz `angular.io`
 1. ejecute `gulp serve-and-sync`
 1. el navegador se lanzará en localhost:3000 y se mantendrá actualizado automáticamente.
 

public/_data.json

@@ -10,8 +10,8 @@
   },
 
   "contribute": {
-    "title": "Contribute to Angular",
-    "subtitle": "Help us build the framework of the future!",
+    "title": "Contribuye a Angular",
+    "subtitle": "Ayudanos a construir el framework del futuro.",
     "autoformat": "true"
   },
 

public/contribute.jade

@@ -1,33 +1,49 @@
 .l-main-section
   h2 Angular Projects
+  h2 Proyectos de Angular
+
   p We'd love for you to contribute to our source code and to make Angular projects even better.
+  p Nos encantaría que contribuya a nuestro código fuente y hacer hacer los proyectos de Angular aún mejores.
 
   .l-sub-section
     h3 Angular 2
 
     p Angular 2 is a next generation mobile and desktop application development platform.
+    p Angular 2 es una plataforma de nueva generación para desarrollar aplicaciones móviles y web.
+
+    a(href="https://github.com/angular/angular/blob/master/CONTRIBUTING.md" class="button" md-button) Contribuye a Angular 2
+
+  .l-sub-section
+    h3 Angular-Es
+
+    p Angular-es es el website con la documentación e información acerca de Angular 2 en español.
+
+    a(href="https://github.com/angular/angular-es" class="button" md-button) Contribuye a Angular-Es
 
-    a(href="https://github.com/angular/angular/blob/master/CONTRIBUTING.md" class="button" md-button) Contribute to Angular 2
 
   .l-sub-section
     h3 Angular for JavaScript or Dart
+    h3 Angualr para Javascript o Dart
 
     p Angular is a development platform for building mobile and desktop applications.
+    p Angular es una plataforma de desarrollo para aplicaciones móviles y web.
 
-    a(href="https://github.com/angular/angular.js/blob/master/CONTRIBUTING.md" class="button" md-button) Contribute to Angular for JS
+    a(href="https://github.com/angular/angular.js/blob/master/CONTRIBUTING.md" class="button" md-button) Contribuye to Angular para JavaScript
 
-    a(href="https://github.com/angular/angular.dart/blob/master/CONTRIBUTING.md" class="button" md-button) Contribute to Angular for DART
+    a(href="https://github.com/angular/angular.dart/blob/master/CONTRIBUTING.md" class="button" md-button) Contribuye a Angular para DART
 
   .l-sub-section
     h3 Angular Material
 
     p Our goal is to deliver a lean, lightweight set of Angular-based UI elements that implement the material design specification for use in Angular single-page applications (SPAs).
+    p Tiene como objectivo ser una serie de elementos UI, livianos, para Angular, que implmentan la especificación de diseño material para usar en aplicaciones web de Angular (SPAs).
 
-    a(href="https://github.com/angular/material/blob/master/.github/CONTRIBUTING.md" class="button" md-button) Contribute to Angular Material
+    a(href="https://github.com/angular/material/blob/master/.github/CONTRIBUTING.md" class="button" md-button) Contribuye a Angular Material
 
   .l-sub-section
     h3 AngularFire
 
     p AngularFire is the officially supported Angular binding for Firebase. Firebase is a full backend so you don't need servers to build your Angular app.
+    p AngularFire es la librería con soporte oficial para usar Angular con Firebase. Firebase es un servicio de backend que te permite escribir aplicaciones de Angular sin tener que mantener tus servidores.
 
-    a(href="https://github.com/firebase/angularFire" class="button" md-button) Contribute to AngularFire
+    a(href="https://github.com/firebase/angularFire" class="button" md-button) Contribuye a AngularFire