feat: add guides to update-origin and contributing

- README.md
- UPDATE-ORIGIN.md
- CONTRIBUTING.md

Auto stash before rebase of "refs/heads/main"

Author: ricardochl

CONTRIBUTING.md

@@ -0,0 +1,87 @@
+# Contribución al proyecto angular-docs-es
+
+## Configuración de origin
+
+- `origin`: Manejo del repositorio `angular/angular`como un submódulo.
+- `adev-es`:  Se administra el contenido de la documentación de Angular, aquí se encuentran los archivos traducidos y no traducidos en formato markdown.
+
+## Configuración del directorio de adev
+
+ Básicamente traduce archivos de Markdown en el directorio `content`.  Si es necesario, también puede agregar el código fuente de la aplicación.
+
+```
+origin/adev/
+├── README.md
+├── content # Archivos de recursos de documentación escritos en Markdown, HTML, etc. Traduzca principalmente los archivos aquí.
+│   ├── best-pratices 
+│   ├── ecosystem
+│   ├── guide 
+│   ├── introduction
+│   ├── references 
+│   ├── tools
+│   ├── error.md
+│   └── kitchen-sink.md
+├── app # Contenido de la aplicación de angular.dev
+...
+```
+
+## Creación de un problema de traducción
+
+ Antes de comenzar el trabajo de traducción, vamos a comprobar si no hay nadie que está tratando de traducir el mismo archivo.  Si miras la etiqueta de [docs-translation](https://github.com/angular-hispano/angular-docs-es/labels/docs-translation), puedes ver el área en la que se está trabajando actualmente en la traducción.  Si desea hacer una nueva traducción, primero cree un [problema en Github](https://github.com/angular-hispano/angular-docs-es/issues) y complete la información de acuerdo con la plantilla.
+ 
+## Crear una solicitud de extracción de traducción
+
+ Empuja los cambios al repositorio donde bifurcaste `angular/angular-docs-es` y envía una solicitud de extracción a la fuente de bifurcación.  Las solicitudes de extracción se revisan y luego se fusionan si no hay problemas.
+ 
+## Directrices para la traducción
+
+ Para traducciones al español, por favor sigue las siguientes pautas.
+ 
+### Guarda el texto original como un archivo.en.md
+
+ Para gestionar el `diff` del texto original después de actualizar el origen, guarda el original en el momento de la traducción como un archivo `xx.en.md`.  Si desea traducir un documento nuevo, copie el archivo `xx.md` escrito en inglés al archivo `xx.en.md` y sobrescriba el archivo `xx.md` con la traducción al español.
+
+ Si la traducción es parcial y no del documento completo, no necesitas duplicar/crear el archivo `xx.en.md` simplemente puedes trabajar sobre el archivo `xx.md` con la traducción al español.
+
+### Alinear la posición de salto de línea con la original
+
+ Siempre que sea posible, alinear el número de líneas en la fuente y la traducción, y ayudar a hacer la comprobación de diferencias más fácil al actualizar.
+
+### Recomendaciones
+
+- Bifurca este repositorio en tu espacio de trabajo de Github para poder colaborar de una manera más limpia y ordenada.
+
+- Se recomienda encarecidamente firmar todos los commits que envíes al repositorio. Esto ayudará a mantener la integridad y la seguridad del código base, y a fomentar un entorno de colaboración más confiable entre los desarrolladores.
+
+## Configura tu entorno local
+
+### 1.  Clonación del repositorio
+
+```
+$ git clone [email protected]:angular-hispano/angular-docs-es.git
+```
+
+### 2. Servidor de desarrollo
+ 
+ Al iniciar el servidor local de desarrollo, puede traducir mientras comprueba el resultado de la compilación.
+
+```
+$ yarn start
+```
+
+ El navegador se iniciará automáticamente cuando el servidor local esté listo `adev-es` será reconstruido automáticamente al cambiar un archivo en el directorio.
+
+  
+ ### 3. Construye para producción
+ 
+ Construye el proyecto desplegable con el siguiente comando.
+
+```
+$ yarn build
+```
+
+Cuando se completa la compilación, el resultado de la compilación se envía al directorio `build/dist/bin/adev/build`. Puedes configurar un servidor de desarrollo con tu herramienta favorita y comprobar los sitios construidos.
+
+## Gracias por tu colaboración!
+
+Esperamos que te unas a nosotros en este esfuerzo por hacer que la documentación de Angular sea más accesible para la comunidad hispanohablante.

README.md

@@ -0,0 +1,21 @@
+# Documentación de Angular en Español
+
+¡Bienvenido al repositorio de traducción al español de la documentación de Angular!
+
+Este proyecto tiene como objetivo crear una versión completa en español de la documentación oficial de Angular. La documentación está escrita en Markdown, lo que facilita la traducción y colaboración.
+
+Puedes conocer más sobre este proyecto en [Angular Hispano](https://angular.lat/)
+
+## Contrubuciones
+
+Si deseas colaborar con este proyecto, puedes contribuir a la traducción de documentos, revisa la guía de contribución en [CONTRIBUTING.md](./CONTRIBUTING.md).
+
+
+## Actualizar el origen
+
+Revisa la guia de actualización en [UPDATE-ORIGIN.md](./UPDATE-ORIGIN.md)
+
+
+## Comunidad
+
+Puedes unirte a nuestra comunidad en [Angular Hispano Discord](https://discord.gg/zRsMufaS)

UPDATE-ORIGIN.md

@@ -0,0 +1,45 @@
+# Actualizar el origen al contenido actual de angular.dev
+
+## Flujo de trabajo
+
+Para actualizar el origen que se encuentra en la carpeta `origin` simplemente debes ejecutar el comando `npm run update-origin` y debes pasar como primer argumento el id del commit que deseas actualizar.
+
+Ejemplo: `npm run update-origin 123456789`
+
+Este script se encargara se actualizar de actualizar la carpeta `origin` con el contenido del commit que se le pasa como argumento y adicional actualizara la carpeta `adev-es` si es necesario ya que esa carpeta contiente las guías de la documentación de Angular.
+
+## Migración
+
+### Patrón 1 - Archivos sin traducción
+
+- `form-validation.md` (no traducido)
+- `reactive-form.md`
+- `structural-directives.md`
+
+Si no hay ningún archivo traducido, se aplicará tal cual.
+
+### Patrón 2 - Archivo con traducción
+
+##### Si el cambio es pequeño
+
+- `form-validation.en.md` (si tiene la extención `en.md` significa que ya está traducido, parcial o totalmente)
+- `reactive-form.en.md`
+- `structural-directives.en.md`
+
+##### Si el cambio es pequeño
+
+Si algún cambio requiere una nueva traducción, se reflejará en el archivo `xx.en.md`. Puedes agregar la traducción al archivo `xx.md`.
+
+##### Si el cambio es grande
+
+1. Copie el texto original en la parte correspondiente del archivo traducido, dejándolo sin traducir, para que tenga un estado mixto en inglés y español.
+
+2. Cree un problema en Github solicitando traducciones para las partes no traducidas.
+
+### Patrón 3 - Código de aplicación adev
+
+Algunos archivos se han modificado para modificar la aplicación angular.dev.
+
+- `sub-navigation-data.ts`
+
+Si bien no es un archivo de contenido (markdown), manejaremos este archivo de la misma manera que un Markdown ya que debe ser traducido al español.