Translated intro

docs/intro/community.rst

@@ -1,33 +1,33 @@
 .. _the-community:
 
-The Community
-=============
+La Comunidad
+============
 
 BDFL
 ----
 
-Guido van Rossum, the creator of Python, is often referred to as the BDFL — the
+Guido van Rossum, creador de Python, es a menudo referido como el BDFL — el
 Benevolent Dictator For Life.
 
 
 
 Python Software Foundation
 --------------------------
 
-The mission of the Python Software Foundation is to promote, protect, and
-advance the Python programming language, and to support and facilitate the
-growth of a diverse and international community of Python programmers.
+La misión de la Fundación de Software Python es promover, proteger, y
+mejorar el lenguaje de programación Python, y soportar y facilitar el crecimiento
+de las diversas e internacionales comunidades de programadores Python.
 
 `Learn More about the PSF <http://www.python.org/psf/>`_.
 
 
 PEPs
 ----
 
-PEPs are *Python Enhancement Proposals*. They describe changes to Python itself,
-or the standards around it.
+PEPs son *Python Enhancement Proposals* (Propuestas de mejora de Python). Describen cambiar Python,
+o los estandares alrededor del lenguaje en sí.
 
-There are three different types of PEPs (as defined by :pep:`1`):
+Hay diferentes tipos de PEPs (as defined by :pep:`1`):
 
     **Standards**
         Describes a new feature or implementation.

docs/intro/documentation.rst

@@ -1,10 +1,10 @@
-Documentation
+Documentación
 =============
 
-Official Documentation
-----------------------
+Documentación Oficial
+---------------------
 
-The official Python Language and Library documentation can be found here:
+El Lenguaje oficial Python y la documentación de Librería puede ser encontrada aquí:
 
     - `Python 2.x <https://docs.python.org/2/>`_
     - `Python 3.x <https://docs.python.org/3/>`_
@@ -13,27 +13,27 @@ The official Python Language and Library documentation can be found here:
 Read the Docs
 -------------
 
-Read the Docs is a popular community project that hosts documentation
-for open source software. It holds documentation for many Python modules,
-both popular and exotic.
+Read the Docs es un popular proyecto de la comunidad que hospeda documentación
+para software open source. Mantiene documentación para varios módulos Python,
+populares y exóticos.
 
     `Read the Docs <https://readthedocs.org/>`_
 
 
 pydoc
 -----
 
-:program:`pydoc` is a utility that is installed when you install Python.
-It allows you to quickly retrieve and search for documentation from your
-shell. For example, if you needed a quick refresher on the
-:mod:`time` module, pulling up documentation would be as simple as
+:program:`pydoc` es una utilidad que esta instalada cuando instalas Python.
+Te permite obtener rápidamente y buscar documentación desde tu consola.
+Por ejemplo, si necesitas un refresco rápido del módulo
+:mod:`time`, buscar la documentación sería tan simple como
 
     .. code-block:: console
 
        $ pydoc time
 
-The above command is essentially equivalent to opening the Python REPL
-and running
+El comando anterior es esencialmente equivalente a abrir el Python REPL
+y ejecutar
 
     .. code-block:: pycon
 

docs/intro/duction.rst

@@ -1,88 +1,89 @@
-Introduction
+Introducción
 ============
 
-From the `official Python website <http://python.org/about/>`_:
+Desde el `sitio web oficial de Python <http://python.org/about/>`_:
 
-Python is a general-purpose, high-level programming language similar
-to Tcl, Perl, Ruby, Scheme, or Java. Some of its main key features
-include:
+Python es un lenguaje de programación de propósito general y alto nivel similar
+a Tcl, Perl, Ruby, Scheme, o Java. Algunos de sus características principales
+incluye:
 
-* **very clear, readable syntax**
+* **muy limpio, sintáxis legible**
 
-  Python's philosophy focuses on readability, from code blocks
-  delineated with significant whitespace to intuitive keywords in
-  place of inscrutable punctuation.
+  La filosofía de Python se enfoca en legibilidad, desde bloques de código
+  delineados con espacios en blanco significativos para intuir palabras claves
+  en lugar de puntuación inescrutable.
 
-* **extensive standard libraries and third party modules for virtually
-  any task**
+* **librerías estandar extensas y módulos de terceros para prácticamente
+  cualquier tarea**
 
-  Python is sometimes described with the words "batteries included"
-  because of its extensive
-  `standard library <http://docs.python.org/library/>`_, which includes
-  modules for regular expressions, file IO, fraction handling,
-  object serialization, and much more.
+  Python a veces es descrito con las palabras "baterías incluídas"
+  por su extensa
+  `librería estandar <http://docs.python.org/library/>`_, que incluye
+  módulos para expresiones regulares, IO de archivos, manejo de fracciones,
+  serialización de objetos, y mucho más.
 
-  Additionally, the
-  `Python Package Index <http://pypi.python.org/pypi/>`_ is available
-  for users to submit their packages for widespread use, similar to
-  Perl's `CPAN <http://www.cpan.org>`_. There is a thriving community
-  of very powerful Python frameworks and tools like
-  the `Django <http://www.djangoproject.com>`_ web framework and the
-  `NumPy <http://numpy.scipy.org>`_ set of math routines.
+  Adicionalmente, el
+  `Indice de Paquetes Python <http://pypi.python.org/pypi/>`_ está disponible
+  para usuarios para publicar sus paquetes para uso extendido, similar a
+  Perl's `CPAN <http://www.cpan.org>`_. Hay una próspera comunidad
+  de muy fuertes frameworks de Python y herramientas como
+  el framework web `Django <http://www.djangoproject.com>`_ y
+  `NumPy <http://numpy.scipy.org>`_ conjunto de rutinas matemáticas.
 
-* **integration with other systems**
+* **integración con otros sistemas**
 
-  Python can integrate with `Java libraries <http://www.jython.org>`_,
-  enabling it to be used with the rich Java environment that corporate
-  programmers are used to. It can also be
-  `extended by C or C++ modules <http://docs.python.org/extending/>`_
-  when speed is of the essence.
+  Python puede integrar con `librerías Java <http://www.jython.org>`_,
+  activando para ser usado con el ambiente Java al que los programadores
+  corporativos están acostumbrados. También puede extenderse con
+  `módulos C o C++ <http://docs.python.org/extending/>`_
+  cuando la velocidad es la esencia.
 
-* **ubiquity on computers**
+* **omnipresencia en computadores**
 
-  Python is available on Windows, \*nix, and Mac. It runs wherever the
-  Java virtual machine runs, and the reference implementation CPython
-  can help bring Python to wherever there is a working C compiler.
+  Python está disponible en Windows, \*nix, y MacOS. Corre donde quiera
+  que la maquina virtual de Java corra, y la implementación de referencia CPython
+  puede ayudar a llevar a Python a donde quiera que este trabajando un compilador de C.
 
-* **friendly community**
+* **comunidad amigable**
 
-  Python has a vibrant and large :ref:`community <the-community>`
-  which maintains wikis, conferences, countless repositories,
-  mailing lists, IRC channels, and so much more. Heck, the Python
-  community is even helping to write this guide!
+  Python tiene una vibrante y larga :ref:`comunidad <the-community>`
+  que mantiene wikis, conferencias, incontables repositorios,
+  listas de correo, canales IRC, y mucho más. Diablos, la comunidad
+  de Python incluso ayudo a escribir esta guía!
 
 
 .. _about-ref:
 
-About This Guide
-----------------
+Acerca de Esta Guía
+-------------------
 
-Purpose
-~~~~~~~
+Propósito
+~~~~~~~~~
 
-The Hitchhiker's Guide to Python exists to provide both novice and expert
-Python developers a best practice handbook for the installation, configuration,
-and usage of Python on a daily basis.
+La Guía de Hitchhiker para Python existe para proporcionar tanto a novatos
+y expertos desarrolladores de Python un manual de las mejores prácticas para
+instalación, configuración, y uso de Python diariamente.
 
 
-By the Community
+Por la Comunidad
 ~~~~~~~~~~~~~~~~
 
-This guide is architected and maintained by `Kenneth Reitz
-<https://github.com/kennethreitz>`_ in an open fashion. This is a
-community-driven effort that serves one purpose: to serve the community.
+Esta guía es diseñada y mantenida por `Kenneth Reitz
+<https://github.com/kennethreitz>`_ de manera abierta. Esto es un
+esfuerzo comunitario que tiene un propósito: servir a la comunidad.
 
-For the Community
+Para la Comunidad
 ~~~~~~~~~~~~~~~~~
 
-All contributions to the Guide are welcome, from Pythonistas of all levels.
-If you think there's a gap in what the Guide covers, fork the Guide on
-GitHub and submit a pull request.
+Todas las contribuciones a la guía son bienvenidas, desde Pythonistas
+de todos los niveles. Si crees que hay una brecha en lo que cubre la Guía,
+crea un fork en Github y envía una solicitud de cambio.
 
-Contributions are welcome from everyone, whether they're an old hand or a
-first-time Pythonista, and the authors to the Guide will gladly help if you
-have any questions about the appropriateness, completeness, or accuracy of
-a contribution.
+Contribuciones son bienvenidas de todo el mundo, ya sea un veterano o
+Pythonista nuevo, y los autores de la Guía con mucho gusto te ayudarán si
+tienes algunas preguntas acerca de la adecuación, integridad, o exactitud
+de una contribución.
 
-To get started working on The Hitchhiker's Guide,
-see the :doc:`/notes/contribute` page.
+
+Para empezar a trabajar en la Guía de Hitchhiker,
+mira la página :doc:`/notes/contribute`.

docs/intro/learning.rst

@@ -1,19 +1,19 @@
-Learning Python
-===============
+Aprendiendo Python
+==================
 
-Beginner
---------
+Principiante
+------------
 
-The Python Tutorial
-~~~~~~~~~~~~~~~~~~~~
+Tutorial de Python
+~~~~~~~~~~~~~~~~~~~
 
-This is the official tutorial. It covers all the basics, and offers a tour of
-the language and the standard library. Recommended for those who need a
-quick-start guide to the language.
+Este es el tutorial oficial. Cubre todo lo básico, y ofrece un tour del
+lenguaje y la librería estadar. Recomendado para quieres necesitan una guía de inicio
+rápido al lenguaje.
 
-    `The Python Tutorial <http://docs.python.org/tutorial/index.html>`_
+    `El Tutorial de Python <http://docs.python.org/tutorial/index.html>`_
 
-Python for Beginners
+Python para Principiantes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 thepythonguru.com is a tutorial focuses on beginner programmers. It covers many python concepts

docs/writing/structure.rst

@@ -1,12 +1,12 @@
-Structuring Your Project
-========================
-
-By "structure" we mean the decisions you make concerning
-how your project best meets its objective. We need to consider how to
-best leverage Python's features to create clean, effective code.
-In practical terms, "structure" means making clean code whose logic and
-dependencies are clear as well as how the files and folders are organized
-in the filesystem.
+Estructurando tu Proyecto
+=========================
+
+Por "estructura" queremos decir las desiciones que conciernen en
+como tu proyecto cumple sus objetivos.. Necesitamos considerar como
+aprovechar mejor los atributos de Python para crear código efectivo y limpio.
+En términos prácticos, "estructura" significa hacer código limpio con lógica y dependencia
+son limpias tan bien como los archivos y directorios estan organizados
+en el sistema de archivos.
 
 Which functions should go into which modules? How does data flow through
 the project? What features and functions can be grouped together and