Merge pull request #3845 from lucianobaraglia/translation-es

Spanish start-workflow.md [skip ci]

docs/guide-es/intro-upgrade-from-v1.md

@@ -45,7 +45,7 @@ Namespace
 ---------
 
 El cambio más obvio en Yii 2.0 es el uso de namespaces. Casi todas las clases del núcleo
-utilizan namespaces, e.j., `yii\web\Request`. El prefijo "C" no se utiliza más en los nombre de clases.
+utilizan namespaces, ej., `yii\web\Request`. El prefijo "C" no se utiliza más en los nombre de clases.
 El esquema de nombre ahora utiliza la ruta de directorios. Por ejemplo, `yii\web\Request`
 indica que el archivo de la clase correspondiente es `web/Request.php`, en el directorio de Yii.
 
@@ -114,7 +114,7 @@ Se puede encontrar mayor detalle acerca del tema en la sección [Configuración
 Eventos
 -------
 
-En Yii 1, los eventos eran creados definiendo un método `on` (e.j., `onBeforeSave`). En Yii 2, puedes utilizar cualquier nombre de evento.
+En Yii 1, los eventos eran creados definiendo un método `on` (ej., `onBeforeSave`). En Yii 2, puedes utilizar cualquier nombre de evento.
 Ahora puedes disparar un evento utilizando el método [[yii\base\Component::trigger()|trigger()]]:
 
 ```php
@@ -282,7 +282,7 @@ Las aplicaciones de consola ahora están organizadas en controladores, tal como
 deben extender de [[yii\console\Controller]], similar a `CConsoleCommand` en 1.1.
 
 Para correr un comando de consola, utiliza `yii <ruta>`, donde `<ruta>` se refiere a la ruta del controlador
-(e.j. `sitemap/index`). Los argumentos anónimos adicionales son pasados como parámetros al método de la acción correspondiente
+(ej. `sitemap/index`). Los argumentos anónimos adicionales son pasados como parámetros al método de la acción correspondiente
 del controlador, mientras que los argumentos especificados son pasados de acuerdo a las declaraciones en [[yii\console\Controller::options()]].
 
 Yii 2.0 soporta la generación automática de información de ayuda de los comandos a través de los bloques de comentarios del archivo.
@@ -332,7 +332,7 @@ Assets
 
 Yii 2.0 introduce un nuevo concepto llamado *asset bundle* que reemplaza el concepto de script package encontrado en Yii 1.1.
 
-Un asset bundle es una colección de assets (e.j. archivos JavaScript, archivos CSS, imágenes, etc.) dentro de un directorio.
+Un asset bundle es una colección de assets (ej. archivos JavaScript, archivos CSS, imágenes, etc.) dentro de un directorio.
 Cada asset bundle por una clase que extiende de [[yii\web\AssetBundle]].
 Al registrar un asset bundle a través de [[yii\web\AssetBundle::register()]], haces que los assets de dicho bundle sean accesibles
 vía Web. A diferencia de Yii 1, la página que registra el bundle contendrá automáticamente las referencias a los archivos

docs/guide-es/start-workflow.md

@@ -0,0 +1,96 @@
+Corriendo Aplicaciones
+======================
+
+Después de instala Yii, tienes una aplicación totalmente funcional a la que se puede acceder a través de
+la URL `http://hostname/basic/web/index.php` o `http://hostname/index.php`, dependiendo de tu configuración.
+Esta sección será una introducción a la funcionalidad incluida de la aplicación, cómo se organiza el código,
+y cómo la aplicación maneja los requests en general.
+
+> Información: Por simplicidad, en el transcurso de este tutorial "Para Empezar", se asume que has definido `basic/web`
+  como el document root de tu servidor Web, y configurado la URL de acceso a tu aplicación para que sea `http://hostname/index.php`
+  o similar.
+  Dependiendo de tus necesidades, por favor ajusta dichas URLs.
+
+
+Funcionalidad <a name="functionality"></a>
+-------------
+
+La aplicación básica contiene 4 páginas:
+
+* Página principal, mostrada cuando se accede a la URL `http://hostname/index.php`,
+* página "Acerca de (About)",
+* la página "Contacto (Contact)", que muestra un formulario de contacto que permite a los usuarios
+  finales contactarse vía email,
+* y la página "Login", que muestra un formulario para loguearse que puede usarse para autenticar usuarios. 
+  Intenta loguearte con "admin/admin", y verás que el elemento "Login" del menú principal cambiará a "Logout".
+
+Estas páginas comparten un encabezado y un pie. El encabezado contiene una barra con el menú principal que permite
+la navegación entre las diferentes páginas.
+
+También deberías ver una barra en la parte de abajo de la ventana del navegador.
+Esta es la útil [herramienta de depuración](tool-debugger.md) provista por Yii para registrar y mostrar mucha información de depuración,
+tal como mensajes de log, response status, las consultas ejecutadas a la base de datos, y más.
+
+
+Estructura de la aplicación <a name="application-structure"></a>
+---------------------------
+
+Los archivos y directorios más importantes en tu aplicación son (asumiendo que la raíz de la aplicación es `basic`):
+
+```
+basic/                  base path de la aplicación
+    composer.json       archivo utilizado por Composer, describe información de sus paquetes y librerías
+    config/             contiene la configuración de las aplicaciones (y otras)
+        console.php     configuración de la aplicación de consola
+        web.php         configuración de la aplicación web
+    commands/           contiene las clases de comandos de consola
+    controllers/        contiene las clases de los controladores
+    models/             contienes las clases del modelo
+    runtime/            contiene archivos generados por Yii en tiempo de ejecución, como archivos de log y cache
+    vendor/             contiene los paquetes y librerías instalados por Composer, incluyendo el propio núcleo de Yii
+    views/              contiene los archivos de vistas (templates)
+    web/                raíz web de la aplicación, contiene los archivos accesibles vía Web
+        assets/         contiene los assets publicados (javascript y css) por Yii
+        index.php       el script de entrada (o bootstrap) de la aplicación
+    yii                 el script de ejecución de los comandos de consola de Yii
+```
+
+En general, los archivos de la aplicación pueden ser divididos en dos: aquellos bajo `basic/web` y aquellos bajo otros directorios.
+Los primeros pueden accederse directo por HTTP (ej., en un navegador), mientras que los últimos no pueden ni deben ser accedidos así.
+
+Yii implementa el patrón de diseño [modelo-vista-controlador (MVC)](http://wikipedia.org/wiki/Model-view-controller),
+que es reflejado en la estructura de directorios utilizada. El directorio `models` contiene todas las [clases del modelo](structure-models.md),
+el directorio `views` contiene todas las [vistas (templates)](structure-views.md), y el directorio `controllers` contiene
+todas las [clases de controladores](structure-controllers.md).
+
+El siguiente diagrama muestra la estructura estática de una aplicación.
+
+![Estructura Estática de una Aplicación](images/application-structure.png)
+
+Cada aplicación tiene un script de entrada `web/index.php` que es el único script PHP accesible vía web.
+El script de entrada toma un request entrante y crea una instancia de una [aplicación](structure-applications.md) para manejarlo.
+La [aplicación](structure-applications.md) resuelve el request con la ayuda de sus [componentes](concept-components.md),
+y envía el request a los elementos MVC. Los [widgets](structure-widgets.md) son usados en las [vistas](structure-views.md)
+para ayudar a construir elementos de interfáz complejos y dinámicos.
+
+
+Ciclo de Vida de un Request <a name="request-lifecycle"></a>
+---------------------------
+
+El siguiente diagrama muestra cómo una aplicación maneja un request.
+
+![Ciclo de Vida de un Request](images/application-lifecycle.png)
+
+1. Un usuario realiza un request al [script de entrada](structure-entry-scripts.md) `web/index.php`.
+2. El script de entrada carga la [configuración](concept-configurations.md) de la aplicación y crea
+   una instancia de la [aplicación](structure-applications.md) para manejar el request.
+3. La aplicación resuelve la [ruta](runtime-routing.md) solicitada con la ayuda del
+   componente [request](runtime-requests.md) de la aplicación.
+4. La aplicación crea una instancia de un [controlador](structure-controllers.md) para manejar el request.
+5. El controlador crea una instancia de una [acción](structure-controllers.md) y ejecuta los filtros de dicha acción.
+6. Si alguno de los filtros falla, la acción es cancelada.
+7. Si todos los filtros pasan, la acción es ejecutada.
+8. La acción carga datos del modelo, posiblemente de la base de datos.
+9. La acción renderiza una vista, pasándole los datos del modelo cargado.
+10. El resultado de la renderización es pasado al componente [response](runtime-responses.md) de la aplicación.
+11. El componente response envía el resultado de la renderización al navegador del usuario.