Rearranged the format to the format used by the English section.

Corrected some minor syntax and grammatical mistakes.
mattetti · Jan 30, 2009 · 0a206b5 · 0a206b5
1 parent 05d3d69
commit 0a206b5
Show file tree

Hide file tree

Showing 5 changed files with 113 additions and 89 deletions.
diff --git a/book-content/es/1-introduction/1-ruby.markdown b/book-content/es/1-introduction/1-ruby.markdown
@@ -8,7 +8,6 @@
 * Esto será una tabla de contenidos (este texto será pegado).
 {:toc}
 
-
 > Programar en Ruby me hace feliz porque es uno de los caminos más cortos entre
 > mi cerebro y una computadora. Puedo pensar en algo y expresarlo de manera
 > sucinta y elegante en Ruby sin utilizar ningún tipo de artilugios extraños que
@@ -29,7 +28,7 @@ por el [arquitecto de software][] japonés
 Ruby se enfoca en la simplicidad y en la productividad. Tiene una sintaxis
 elegante que es natural para leer y fácil para escribir.
 
-Matz tomó prestadas ideas y construcciones inspiradas en algunos de sus
+[Matz][] tomó prestadas ideas y construcciones inspiradas en algunos de sus
 lenguajes de programación favoritos ([Perl][], [Smalltalk][], [Eiffel][],
 [Ada][], y [Lisp][]) para conformar un nuevo lenguaje que balancea la
 [programación funcional][] con la [programación imperativa][].
@@ -50,7 +49,7 @@ popularidad del software escrito en Ruby, particularmente la
 
 > Yo quería un lenguaje de script más poderoso que Perl, y más orientado a
 > objetos que Python.
-> - Matz
+> - [Matz][]
 {: cite=http://www.linuxdevcenter.com/pub/a/linux/2001/11/29/ruby.html}
 
 * Todo es un objeto
@@ -82,7 +81,7 @@ Para aprender más sobre el lenguaje Ruby, referirse al [Sitio Oficial del lengu
 es equivalente a:
 
     if edad > 12
-        clasificacion_edad =  "adulto"
+        clasificacion_edad = "adulto"
     else
         clasificacion_edad = "niño"
     end
@@ -91,7 +90,7 @@ es equivalente a:
 **Arreglos:**
 
     bebidas = ["Coke", "Pepsi", "Orangina", "DrPepper"]
-    #    => ["Coke,", "Pepsi,", "Orangina,", "DrPepper"]
+    # => ["Coke", "Pepsi", "Orangina", "DrPepper"]
     # Acceder la instancia del Arreglo
     bebidas[0] # => "Coke"
     bebidas.first # => "Coke"
@@ -100,7 +99,6 @@ es equivalente a:
     bebidas[bebidas.length - 1] # => "DrPepper"
 {:lang=ruby html_use_syntax=true}
 
-
 **Verificar si un item existe en una instancia de un Arreglo:**
 
     pajar = ["Mac", "NT", "Irix", "Linux"]
@@ -113,7 +111,7 @@ es equivalente a:
     pajar = ["Mac", "NT", "Irix", "Linux"]
     aguja = "Windows"
     pajar.push(aguja)
-    # Or do it like this:
+    # O también puede hacerse de este manera :
     pajar << aguja
 {:lang=ruby html_use_syntax=true}
 
@@ -129,7 +127,7 @@ es equivalente a:
 Merb intenta de ser tan parecido al lenguaje Ruby como sea posible.
 Por eso es que es importante entender lo que se ha dado en llamar la "Manera Ruby".
 
-Durante RubyConf 2008, Matz hizo un comentario sobre Merb:
+Durante [RubyConf 2008][], Matz hizo un comentario sobre Merb:
 
 > Merb tiene un futuro brillante para aquellos que no están satisfechos con las
 > pautas fijadas por Rails. Yo pienso que Merb le dará a los usuarios más
@@ -138,25 +136,25 @@ Durante RubyConf 2008, Matz hizo un comentario sobre Merb:
 {: cite=http://merbist.com/2008/11/09/merb-1-0-released/}
 
 [Ada]: http://en.wikipedia.org/wiki/Ada_%28programming_language%29)
-[Dave Thomas]:          http://pragdave.pragprog.com/
-[dinámico]:              http://en.wikipedia.org/wiki/Dynamic
+[Dave Thomas]: http://pragdave.pragprog.com/
+[dinámico]: http://en.wikipedia.org/wiki/Dynamic
 [Eiffel]: http://en.wikipedia.org/wiki/Eiffel_%28programming_language%29
 [programación funcional]: http://en.wikipedia.org/wiki/Functional_programming
 [programación imperativa]: http://en.wikipedia.org/wiki/Imperative_programming
 [Lisp]: http://en.wikipedia.org/wiki/Lisp_%28programming_language%29
-[Matz]:                 http://en.wikipedia.org/wiki/Yukihiro_Matsumoto
+[Matz]: http://en.wikipedia.org/wiki/Yukihiro_Matsumoto
 [orientado a objectos]: http://en.wikipedia.org/wiki/Object-oriented_programming
 [sitio oficial del Lenguaje Ruby]: http://www.ruby-lang.org/en/about
-[Código Abierto]:       http://en.wikipedia.org/wiki/Open_Source
-[Perl]:                 http://en.wikipedia.org/wiki/Perl)
+[Código Abierto]: http://en.wikipedia.org/wiki/Open_Source
+[Perl]: http://en.wikipedia.org/wiki/Perl)
 [lenguaje de programación]: http://en.wikipedia.org/wiki/Programming_language
 [Programando en Ruby]: http://pragprog.com/titles/ruby/programming-ruby
 [reflexivo]: http://en.wikipedia.org/wiki/Reflection_%28computer_science%29
 [Sitio Oficial del lenguaje Ruby]: http://ruby-lang.org/
 [lenguaje de programación Ruby]: http://ruby-lang.org/
 [plataforma web Ruby on Rails]: http://rubyonrails.org
-[Smalltalk]:            http://en.wikipedia.org/wiki/Smalltalk
-[arquitecto de software]:   http://en.wikipedia.org/wiki/Software_architect
+[Smalltalk]: http://en.wikipedia.org/wiki/Smalltalk
+[arquitecto de software]: http://en.wikipedia.org/wiki/Software_architect
 [índice TIOBE]: http://www.tiobe.com/index.php/content/paperinfo/tpci/index.html
-[Yukihiro "Matz" Matsumoto-san ( まつもとゆきひろ)]:
-  http://en.wikipedia.org/wiki/Yukihiro_Matsumoto
+[Yukihiro "Matz" Matsumoto-san ( まつもとゆきひろ)]:http://en.wikipedia.org/wiki/Yukihiro_Matsumoto
+[RubyConf 2008]: http://rubyconf.org
diff --git a/book-content/es/1-introduction/2-merb.markdown b/book-content/es/1-introduction/2-merb.markdown
@@ -1,20 +1,27 @@
-## Merb
+# Merb
 
 Merb es la creación de [Ezra Zygmuntowicz][].
-La primera versión 'pública' de Merb apareció como un pastie el 21 de Septiembre
-del 2006.
-Puedes encontrar este pastie [aquí](http://pastie.org/14416) o
-[aquí](http://gist.github.com/33252) (mirror).
-Actualmente el desarrollador lider del proyecto Merb es [Yehuda Katz][].
+La primera versión 'pública' de Merb apareció como un pastie 
+el 21 de Septiembre del 2006[^first-pastie].
+Usted puede encontrar este codigo fuente [aquí][] o [aquí (mirror)][].
+Actualmente, el desarrollador lider del proyecto Merb es [Yehuda Katz][].
 
-A partir de la version 0.9 de la plataforma, toda la funcionalidad esencial fue
-puesta dentro de 'merb-core', con la functionalidad extra restante movida a
-otros componentes (tales como merb-haml y merb-helpers).
-La Version 1.0 se anunció en [RubyConf][] el 7 de Noviembre del 2008.
+A partir de la version 0.9 de la plataforma, 
+toda la funcionalidad esencial fue enpaquetada dentro de 'merb-core', 
+mientras que la restante functionalidad extra fue movida a otros componentes 
+(tales como merb-haml y merb-helpers).
+La Version 1.0 fue anunciada durante [RubyConf 2008][] el día 7 de Noviembre del 2008.
 
-El repositorio principal de código fuente está en [Github][].
+Merb es mantenido usango [Git][], un sistema de control de versiones distribuido.
+El [repositorio][] principal del código fuente está en [Github][].
 
-[Ezra Zygmuntowicz]:  http://brainspl.at/
-[Github]:             http://github.com/wycats/merb/
-[RubyConf]:           http://rubyconf.org/
-[Yehuda Katz]:        http://yehudakatz.com/
+[Ezra Zygmuntowicz]: http://brainspl.at/
+[aquí]: http://pastie.org/14416
+[aquí (mirror)]: http://gist.github.com/33252
+[Yehuda Katz]: http://yehudakatz.com/
+[RubyConf 2008]: http://rubyconf.org/
+[Git]: http://git.or.cz/
+[repositorio]: http://github.com/wycats/merb/
+[Github]: http://github.com/
+
+[^first-pastie]: http://pastie.org/14416
diff --git a/book-content/es/1-introduction/3-datamapper.markdown b/book-content/es/1-introduction/3-datamapper.markdown
@@ -1 +1 @@
-## DataMapper
+# DataMapper
diff --git a/book-content/es/1-introduction/4-rspec.markdown b/book-content/es/1-introduction/4-rspec.markdown
@@ -8,89 +8,89 @@
 
 ## Introducción
 
-[RSpec][] es una plataforma de Desarrollo Dirigido por Comportamiento (Behavior
-Driven Development) para Ruby.
-RSpec provee dos plataformas para escribir y ejecutar ejemplos de como tu
-aplicación debe comportarse[^rspec]:
+[RSpec][] es una plataforma de Desarrollo Dirigido por Comportamiento[^BDD] para Ruby.
+Esta provee, a su vez, dos plataformas para escribir y ejecutar ejemplos
+de como su aplicación Ruby debería comportarse[^rspec]:
 
- * una Plataforma de Escenarios[^cucumber] para describir comportamiento a nivel
-de aplicación
- * una Plataforma de Ejemplos de Código para describir comportamiento a nivel de
-objetos
+ * una plataforma de Escenarios[^cucumber] para describir comportamientos a nivel de aplicación 
+ * una plataforma de Ejemplos de Codigo para describir comportamientos a nivel de objeto.
 
-[RSpec][] fue influenciado by [Dan North][] y su plataforma de pruebas BDD en
-Java llamada [JBehave][].
+[RSpec][] fue influenciado por [Dan North][]
+y su plataforma de pruebas DDC llamada [JBehave][] para el lenguaje [Java][].
 
 ## Historia
 
-Inicialmente BDD era solo una discusión entre [Aslak Hellesøy][] y [Dan North][]
-en la oficina de [ThoughtWorks][] en Londres.
-[Dave Astels][] se unió a la conversación con un post en su blog exponiendo que
-él creía que estas ideas podrían ser facilmente implementadas en [Smalltalk][] o
-[Ruby][].
-[Steven Baker][] se unió con una implementación inicial, y liberó RSpec 0.1.
-Más  tarde en 2006, el mantenimiento fue transferido a [David Chelimsky][].
-[^rspec-history]
-
-
-## Desarrollo Dirigido por Comportamiento (BDD)
-
-Desarrollo Dirigido por Comportamiento (Behavior Driven Development) [^BDD] es
-un proceso de desarrollo [Agil][] que contiene aspectos del Planeo dirigido por
-Test de Aceptación ([Acceptance Test Driven Planning][]), Diseño Dirigido por
-Dominios [Domain Driven Design][] y Desarrollo Dirigido por Pruebas
-[Test Driven Development][].
-
-> El Desarrollo Dirigido por Comportamiento es una metodología “de afuera hacia
-> adentro” (“outside-in”).
-> Comienza en el exterior identificando resultados de negocio, y entonces se
-> enfoca en el conjunto de características que posibilitarán obtener estos
-> resultados.
-> Cada característica es capturada como una “historia”, que define el alcance de
-> la característica junto a su criterios de aceptación.
+Inicialmente, el Desarrollo Dirigido por Comportamiento nació de una conversación entre 
+[Aslak Hellesøy][] y [Dan North][] que tuvo lugar en la oficina londinense de [ThoughtWorks][].
+[Dave Astels][] se unió a la conversación publicando un articulo en su blog,
+sugiriendo que estas ideas podrían ser fácilmente implementadas 
+en [Smalltalk][] o [Ruby][].
+[Steven Baker][] fue quien realizo la primera implementación, 
+conocida como RSpec 0.1.
+A fines del 2006,
+[David Chelimsky][] fue nombrado responsable del mantenimiento de [RSpec][].[^rspec-history]
+
+## Desarrollo Dirigido por Comportamiento
+
+Desarrollo Dirigido por Comportamiento es un proceso de desarrollo [Agil][]
+que incorpora aspectos de la [Planificación Dirigida por Pruebas de Aceptación][],
+el [Diseño Dirigido por Dominios][], y el [Desarrollo Dirigido por Pruebas][].
+
+> El Desarrollo Dirigido por Comportamiento es una metodología "de afuera hacia adentro".
+> Este comienza en el exterior identificando los resultados de negocios, 
+> y luego se enfoca hacia la característica que se encargara de generar esos resultados.
+> Cada característica es capturada como una "historia",
+> la cual define el alcance de la misma junto con su criterio de aceptación.
 > - [Dan North][]{: .quote-author}
 {: cite=http://dannorth.net/whats-in-a-story}
 
-Concentrandose en el comportamiento esperado más que en los detalles técnicos,
-los desarrolladores pueden tener una mejor comunicación con el cliente y otros
-inversores.
+Al enfocarse en los comportamientos esperados y no en los detalles técnicos,
+los programadores pueden entablar una mejor comunicación 
+con el dueño del proyecto y otras personas involucradas en el mismo.
 
 ## Implementación
 
-RSpec es un Lenguaje Específico de Dominio (Domain Specific Language) para
-describir el comportamiento esperado de un sistema mediante ejemplos
-ejecutables.
+RSpec es un [Lenguaje Especifico del Dominio][] 
+que describe el comportamiento esperado de un sistema,
+usando una colección de ejemplos ejecutables.
 
-Aquí está un ejemplo muy simple de RSpec.
+Aquí se le presenta un ejemplo simple de RSpec.
 
     describe "Lector" do
-      it "debe tener un browser" do
+      it "deberia tener un navegador web." do
         lector = Lector.new
-        lector.browser.should_not be_nil
+        lector.navegador_web.should_not be_nil
       end
     end
 {:lang=ruby html_use_syntax=true}
 
 
-[^rspec]:       [RSpec website](http://rspec.info)
-[^cucumber]:    [Cucumber wiki](http://github.com/aslakhellesoy/cucumber/wikis)
-[^BDD]:         [BDD by Dan North](http://dannorth.net/tags/agile/bdd)
-[^rspec-history]:  [Nick Sieger: BDD with RSpec](http://blog.nicksieger.com/articles/2007/11/04/rubyconf-day-3-behaviour-driven-development-with-rspec)
+<!-- References -->
+[^rspec]: [sitio web de RSpec](http://rspec.info)
+[^cucumber]: [Cucumber wiki](http://github.com/aslakhellesoy/cucumber/wikis)
+[^BDD]: [Desarrollo Dirigido por Comportamiento por Dan North](http://dannorth.net/tags/agile/bdd)
+[^rspec-history]: [Desarrollo Dirigido por Comportamiento con RSpec por Nick Sieger](http://blog.nicksieger.com/articles/2007/11/04/rubyconf-day-3-behaviour-driven-development-with-rspec)
 
-[Acceptance Test Driven Planning]: http://testing.thoughtworks.com/node/89
-[Agile]: http://en.wikipedia.org/wiki/Agile_software_development
+<!-- Links -->
+[Planificación Dirigida por Pruebas de Aceptación]: http://testing.thoughtworks.com/node/89
+[Agil]: http://en.wikipedia.org/wiki/Agile_software_development
 [Aslak Hellesøy]: http://blog.aslakhellesoy.com/
 [Dan North]: http://dannorth.net
 [Dave Astels]: http://blog.daveastels.com/
 [David Chelimsky]: http://blog.davidchelimsky.net
-[Domain Driven Design]: http://domaindrivendesign.org/
+[Diseño Dirigido por Dominios]: http://domaindrivendesign.org/
+[Lenguaje Especifico del Dominio]: http://en.wikipedia.org/wiki/Domain_Specific_Language
+[Java]: http://en.wikipedia.org/wiki/Java_(programming_language)
 [JBehave]: http://jbehave.org/
 [RSpec]: http://rspec.info
 [Ruby]: http://ruby-lang.org
 [Smalltalk]: http://www.smalltalk.org
 [Steven Baker]: http://blog.lavalamp.ca
-[Test Driven Development]: http://en.wikipedia.org/wiki/Test-driven_development
+[Desarrollo Dirigido por Pruebas]: http://en.wikipedia.org/wiki/Test-driven_development
 [ThoughtWorks]: http://www.thoughtworks.com/
 
+<!-- Abbreviations -->
+*[BDD]: Behavior Driven Development
+*[DSL]: Domain Specific Language
 *[TDD]: Test Driven Development
-*[BDD]: Behavior Driven Development
+
diff --git a/book-content/es/1-introduction/toc.markdown b/book-content/es/1-introduction/toc.markdown
@@ -1,5 +1,24 @@
-# introduction
+# Introduction
 
- <ul class='toc'><li><a href='/es/introduction/ruby'>El Lenguaje Ruby</a><ul style='list-style: none;'><li><a href='/es/introduction/ruby#origin'>Origen</a></li><li><a href='/es/introduction/ruby#adoption'>Adopción</a></li><li><a href='/es/introduction/ruby#key-elements'>Elementos Claves del lenguaje</a></li><li><a href='/es/introduction/ruby#code-examples'>Ejemplos de Código</a></li><li><a href='/es/introduction/ruby#merb-and-ruby'>Merb y Ruby</a></li></ul></li></ul>
+<ul class='toc'>
+	<li><a href='/es/introduction/ruby'>El Lenguaje Ruby</a>
+		<ul style='list-style: none;'>
+			<li><a href='/es/introduction/ruby#origin'>Origen</a></li>
+			<li><a href='/es/introduction/ruby#adoption'>Adopción</a></li>
+			<li><a href='/es/introduction/ruby#key-elements'>Elementos claves del lenguaje</a></li>
+			<li><a href='/es/introduction/ruby#code-examples'>Ejemplos de código</a></li>
+			<li><a href='/es/introduction/ruby#merb-and-ruby'>Merb y Ruby</a></li>
+		</ul>
+	</li>
+</ul>
 
-<ul class='toc'><li><a href='/es/introduction/rspec'>La plataforma de pruebas RSpec</a><ul style='list-style: none;'><li><a href='/es/introduction/rspec#introducción'>Introducción</a></li><li><a href='/es/introduction/rspec#historia'>Historia</a></li><li><a href='/es/introduction/rspec#desarrollo_dirigido_por_comportamiento_bdd'>Desarrollo Dirigido por Comportamiento (<abbr title='Behavior Driven Development'>BDD</abbr>)</a></li><li><a href='/es/introduction/rspec#implementación'>Implementación</a></li></ul></li></ul> 
+<ul class='toc'>
+	<li><a href='/es/introduction/rspec'>La plataforma de pruebas RSpec</a>
+		<ul style='list-style: none;'>
+			<li><a href='/es/introduction/rspec#introducción'>Introducción</a></li>
+			<li><a href='/es/introduction/rspec#historia'>Historia</a></li>
+			<li><a href='/es/introduction/rspec#desarrollo_dirigido_por_comportamiento_bdd'>Desarrollo Dirigido por Comportamiento (<abbr title='Behavior Driven Development'>BDD</abbr>)</a></li>
+			<li><a href='/es/introduction/rspec#implementación'>Implementación</a></li>
+		</ul>
+	</li>
+</ul>