From 1acdac17ee264d8d9e1a6c14cacff3ed9eebeca9 Mon Sep 17 00:00:00 2001
From: Rodrigote <rodrigojali@gmail.com>
Date: Mon, 4 Feb 2019 19:27:03 -0300
Subject: [PATCH 1/5] Rodrigo Ali - First piece of translation. Creating PR.

---
 content/docs/accessibility.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/content/docs/accessibility.md b/content/docs/accessibility.md
index d387921ca..799ea7027 100644
--- a/content/docs/accessibility.md
+++ b/content/docs/accessibility.md
@@ -1,14 +1,14 @@
 ---
 id: accessibility
-title: Accessibility
+title: Accesibilidad
 permalink: docs/accessibility.html
 ---
 
-## Why Accessibility?
+## ¿Por qué Accesibilidad?
 
-Web accessibility (also referred to as [**a11y**](https://en.wiktionary.org/wiki/a11y)) is the design and creation of websites that can be used by everyone. Accessibility support is necessary to allow assistive technology to interpret web pages.
+La accesibilidad web (también conocida como [** a11y **] (https://en.wiktionary.org/wiki/a11y)) es el diseño y la creación de sitios web que pueden ser utilizados por todos. El soporte de accesibilidad es necesario para permitir que la tecnología de asistencia interprete las páginas web.
 
-React fully supports building accessible websites, often by using standard HTML techniques.
+React es totalmente compatible con la creación de sitios web accesibles, a menudo mediante el uso de técnicas estándar de HTML.
 
 ## Standards and Guidelines
 

From d7e4e3b36c71f8efd47eadfb65ec8fbd35d27a39 Mon Sep 17 00:00:00 2001
From: Rodrigote <rodrigojali@gmail.com>
Date: Thu, 14 Feb 2019 10:53:39 -0300
Subject: [PATCH 2/5] Rodrigo Ali - First half translated. Pending: proof
 reading.

---
 content/docs/accessibility.md | 131 +++++++++++++++++-----------------
 1 file changed, 64 insertions(+), 67 deletions(-)

diff --git a/content/docs/accessibility.md b/content/docs/accessibility.md
index 663251a03..9d5a7782e 100644
--- a/content/docs/accessibility.md
+++ b/content/docs/accessibility.md
@@ -10,23 +10,23 @@ Web accessibility (also referred to as [**a11y**](https://en.wiktionary.org/wiki
 
 React fully supports building accessible websites, often by using standard HTML techniques.
 
-## Standards and Guidelines {#standards-and-guidelines}
+## Normas y lineamientos
 
 ### WCAG {#wcag}
 
-The [Web Content Accessibility Guidelines](https://www.w3.org/WAI/intro/wcag) provides guidelines for creating accessible web sites.
+Las [Pautas de Accesibilidad de Contenido Web (WCAG por sus siglas en inglés)](https://www.w3.org/WAI/intro/wcag) proporcionan pautas para crear sitios web accesibles.
 
-The following WCAG checklists provide an overview:
+Las siguientes listas de verificación WCAG proporcionan una visión general:
 
-- [WCAG checklist from Wuhcag](https://www.wuhcag.com/wcag-checklist/)
-- [WCAG checklist from WebAIM](http://webaim.org/standards/wcag/checklist)
-- [Checklist from The A11Y Project](http://a11yproject.com/checklist.html)
+- [Lista de verificación WCAG de Wuhcag](https://www.wuhcag.com/wcag-checklist/)
+- [Lista de verificación WCAG de WebAIM](http://webaim.org/standards/wcag/checklist)
+- [Lista de verificación de El Proyecto A11Y](http://a11yproject.com/checklist.html)
 
 ### WAI-ARIA {#wai-aria}
 
-The [Web Accessibility Initiative - Accessible Rich Internet Applications](https://www.w3.org/WAI/intro/aria) document contains techniques for building fully accessible JavaScript widgets.
+El documento [Iniciativa de Accesibilidad Web - Aplicaciones de Internet Enriquecidas y Accesibles (WAI-ARIA por sus siglas en inglés)](https://www.w3.org/WAI/intro/aria) contiene técnicas para construir widgets de JavaScript totalmente accesibles.
 
-Note that all `aria-*` HTML attributes are fully supported in JSX. Whereas most DOM properties and attributes in React are camelCased, these attributes should be hyphen-cased (also known as kebab-case, lisp-case, etc) as they are in plain HTML:
+Tenga en cuenta que todos los atributos HTML `aria- *` son totalmente compatibles con JSX. Mientras que la mayoría de las propiedades y atributos de DOM en React son camelCase, estos atributos deben tener un guión (también conocido como kebab-case, lisp-case, etc.) ya que están en HTML simple:
 
 ```javascript{3,4}
 <input
@@ -39,16 +39,16 @@ Note that all `aria-*` HTML attributes are fully supported in JSX. Whereas most
 />
 ```
 
-## Semantic HTML {#semantic-html}
-Semantic HTML is the foundation of accessibility in a web application. Using the various HTML elements to reinforce the meaning of information
-in our websites will often give us accessibility for free.
+## HTML semnántico
 
-- [MDN HTML elements reference](https://developer.mozilla.org/en-US/docs/Web/HTML/Element)
+El HTML semántico es la base de la accesibilidad en una aplicación web. Haciendo uso de los diversos elementos HTML para reforzar el significado de la información en nuestros sitios web a menudo nos dará accesibilidad de forma gratuita.
 
-Sometimes we break HTML semantics when we add `<div>` elements to our JSX to make our React code work, especially when working with lists (`<ol>`, `<ul>` and `<dl>`) and the HTML `<table>`.
-In these cases we should rather use [React Fragments](/docs/fragments.html) to group together multiple elements.
+- [Referencia de elementos HTML en MDN](https://developer.mozilla.org/es/docs/Web/HTML/Elemento)
 
-For example,
+A veces rompemos la semántica HTML cuando agregamos elementos `<div>` a nuestro JSX para hacer que nuestro código React funcione, especialmente cuando trabajamos con listas (`<ol>`, `<ul>` y `<dl>`) y la etiqueta `<table>` de HTML.
+En estos casos, deberíamos usar [Fragmentos React](/docs/fragments.html) para agrupar varios elementos.
+
+Por ejemplo,
 
 ```javascript{1,5,8}
 import React, { Fragment } from 'react';
@@ -73,7 +73,7 @@ function Glossary(props) {
 }
 ```
 
-You can map a collection of items to an array of fragments as you would any other type of element as well:
+Puedes asignar una colección de elementos a un arreglo de fragmentos como lo haría con cualquier otro tipo de elemento:
 
 ```javascript{6,9}
 function Glossary(props) {
@@ -91,7 +91,7 @@ function Glossary(props) {
 }
 ```
 
-When you don't need any props on the Fragment tag you can use the [short syntax](/docs/fragments.html#short-syntax), if your tooling supports it:
+Cuando no necesites ninguna prop en la etiqueta Fragment, puedes usar la [sintaxis corta](/docs/fragments.html#short-syntax), si tus herramientas lo admiten:
 
 ```javascript{3,6}
 function ListItem({ item }) {
@@ -104,83 +104,82 @@ function ListItem({ item }) {
 }
 ```
 
-For more info, see [the Fragments documentation](/docs/fragments.html).
+Para más información, consulta [la documentación de Fragmentos](/docs/fragments.html).
+
+## Formularios accesibles
 
-## Accessible Forms {#accessible-forms}
+### Etiquetado
 
-### Labeling {#labeling}
-Every HTML form control, such as `<input>` and `<textarea>`, needs to be labeled accessibly. We need to provide descriptive labels that are also exposed to screen readers.
+Todos los controles de formulario HTML, como `<input>` y `<textarea>`, deben ser etiquetados de forma accesible. Necesitamos proporcionar etiquetas descriptivas que también estén expuestas a los lectores de pantalla.
 
-The following resources show us how to do this:
+Los siguientes recursos nos muestran cómo hacer esto:
 
-- [The W3C shows us how to label elements](https://www.w3.org/WAI/tutorials/forms/labels/)
-- [WebAIM shows us how to label elements](http://webaim.org/techniques/forms/controls)
-- [The Paciello Group explains accessible names](https://www.paciellogroup.com/blog/2017/04/what-is-an-accessible-name/)
+- [El W3C nos muestra cómo etiquetar elementos](https://www.w3.org/WAI/tutorials/forms/labels/)
+- [WebAIM nos muestra cómo etiquetar elementos](http://webaim.org/techniques/forms/controls)
+- [El Grupo Paciello explica los nombres accesibles](https://www.paciellogroup.com/blog/2017/04/what-is-an-accessible-name/)
 
-Although these standard HTML practices can be directly used in React, note that the `for` attribute is written as `htmlFor` in JSX:
+Aunque estas prácticas estándar de HTML se pueden usar directamente en React, ten en cuenta que el atributo `for` se escribe como `htmlFor` en JSX:
 
 ```javascript{1}
 <label htmlFor="namedInput">Name:</label>
 <input id="namedInput" type="text" name="name"/>
 ```
 
-### Notifying the user of errors {#notifying-the-user-of-errors}
+### Notificando errores al usuario
 
-Error situations need to be understood by all users. The following link shows us how to expose error texts to screen readers as well:
+Las situaciones de error deben ser entendidas por todos los usuarios. El siguiente enlace también nos muestra cómo exponer textos de error a lectores de pantalla:
 
-- [The W3C demonstrates user notifications](https://www.w3.org/WAI/tutorials/forms/notifications/)
-- [WebAIM looks at form validation](http://webaim.org/techniques/formvalidation/)
+- [El W3C demuestra notificaciones de usuario](https://www.w3.org/WAI/tutorials/forms/notifications/)
+- [WebAIM analiza la validación de formularios](http://webaim.org/techniques/formvalidation/)
 
-## Focus Control {#focus-control}
+## Control de foco
 
-Ensure that your web application can be fully operated with the keyboard only:
+Asegúrese de que su aplicación web pueda ser operada completamente solo con el teclado:
 
-- [WebAIM talks about keyboard accessibility](http://webaim.org/techniques/keyboard/)
+- [WebAIM habla sobre accesibilidad de teclado](http://webaim.org/techniques/keyboard/)
 
-### Keyboard focus and focus outline {#keyboard-focus-and-focus-outline}
+### Foco de teclado y contorno de foco
 
-Keyboard focus refers to the current element in the DOM that is selected to accept input from the keyboard. We see it everywhere as a focus outline similar to that shown in the following image:
+El foco del teclado se refiere al elemento actual en el DOM que está seleccionado para aceptar la entrada desde el teclado. Lo vemos en todas partes como un contorno de foco similar al que se muestra en la siguiente imagen:
 
 <img src="../images/docs/keyboard-focus.png" alt="Blue keyboard focus outline around a selected link." />
 
-Only ever use CSS that removes this outline, for example by setting `outline: 0`, if you are replacing it with another focus outline implementation.
+Solamente use CSS que elimine este contorno, por ejemplo, configurando `outline: 0`, si lo va a reemplazar por otra implementación de contorno de foco.
 
-### Mechanisms to skip to desired content {#mechanisms-to-skip-to-desired-content}
+### Mecanismos para omitir hacia el contenido deseado.
 
-Provide a mechanism to allow users to skip past navigation sections in your application as this assists and speeds up keyboard navigation.
+Proporcione un mecanismo para permitir que los usuarios omitan las secciones de navegación en su aplicación, ya que esto ayuda y acelera la navegación con el teclado.
 
-Skiplinks or Skip Navigation Links are hidden navigation links that only become visible when keyboard users interact with the page. They are very easy to implement with
-internal page anchors and some styling:
+Skiplink o Skip Navigation son enlaces de navegación ocultos que solo se hacen visibles cuando los usuarios de teclado interactúan con la página. Son muy fáciles de implementar con anclajes internos de página y algunos estilos:
 
-- [WebAIM - Skip Navigation Links](http://webaim.org/techniques/skipnav/)
+- [WebAIM - Omitir enlaces de navegación](http://webaim.org/techniques/skipnav/)
 
-Also use landmark elements and roles, such as `<main>` and `<aside>`, to demarcate page regions as assistive technology allow the user to quickly navigate to these sections.
+También utilice elementos y roles de puntos de referencia, como `<main>` y `<aside>`, para delimitar las regiones de la página ya que la tecnología de asistencia permite al usuario navegar rápidamente a estas secciones.
 
-Read more about the use of these elements to enhance accessibility here:
+Lea más sobre el uso de estos elementos para mejorar la accesibilidad aquí:
 
-- [Accessible Landmarks](http://www.scottohara.me/blog/2018/03/03/landmarks.html)
+- [Puntos de referencia accesibles](http://www.scottohara.me/blog/2018/03/03/landmarks.html)
 
-### Programmatically managing focus {#programmatically-managing-focus}
+### Gestionando programáticamente el foco.
 
-Our React applications continuously modify the HTML DOM during runtime, sometimes leading to keyboard focus being lost or set to an unexpected element. In order to repair this,
-we need to programmatically nudge the keyboard focus in the right direction. For example, by resetting keyboard focus to a button that opened a modal window after that modal window is closed.
+Nuestras aplicaciones React modifican continuamente el DOM de HTML durante el tiempo de ejecución, lo que a veces hace que el foco del teclado se pierda o se establezca en un elemento inesperado. Para reparar esto, tenemos que empujar programáticamente el foco del teclado en la dirección correcta. Por ejemplo, al restablecer el foco del teclado a un botón que abrió una ventana modal después de que se cierre esa ventana modal.
 
-MDN Web Docs takes a look at this and describes how we can build [keyboard-navigable JavaScript widgets](https://developer.mozilla.org/en-US/docs/Web/Accessibility/Keyboard-navigable_JavaScript_widgets).
+MDN Web Docs analiza esto y describe cómo podemos construir [widgets de JavaScript navegables por el teclado](https://developer.mozilla.org/en-US/docs/Web/Accessibility/Keyboard-navigable_JavaScript_widgets).
 
-To set focus in React, we can use [Refs to DOM elements](/docs/refs-and-the-dom.html).
+Para establecer el foco en React, podemos usar [Referencias a elementos del DOM](/docs/refs-and-the-dom.html).
 
-Using this, we first create a ref to an element in the JSX of a component class:
+Usando esto, primero creamos una referencia a un elemento en el JSX de una clase de componente:
 
 ```javascript{4-5,8-9,13}
 class CustomTextInput extends React.Component {
   constructor(props) {
     super(props);
-    // Create a ref to store the textInput DOM element
+    // Crea una referencia para almacenar el elemento textInput del DOM
     this.textInput = React.createRef();
   }
   render() {
-  // Use the `ref` callback to store a reference to the text input DOM
-  // element in an instance field (for example, this.textInput).
+  // Utiliza la devolución de llamada `ref` para almacenar una referencia al elemento DOM de entrada de texto 
+  // en un campo de instancia (por ejemplo, this.textInput).
     return (
       <input
         type="text"
@@ -191,18 +190,18 @@ class CustomTextInput extends React.Component {
 }
 ```
 
-Then we can focus it elsewhere in our component when needed:
+Entonces podemos enfocarlo en otro lugar de nuestro componente cuando sea necesario:
 
  ```javascript
  focus() {
-   // Explicitly focus the text input using the raw DOM API
-   // Note: we're accessing "current" to get the DOM node
+   // Enfoca explícitamente la entrada de texto usando la API de DOM sin formato
+    // Nota: estamos accediendo a "actual" para obtener el nodo DOM
    this.textInput.current.focus();
  }
  ```
 
-Sometimes a parent component needs to set focus to an element in a child component. We can do this by [exposing DOM refs to parent components](/docs/refs-and-the-dom.html#exposing-dom-refs-to-parent-components)
-through a special prop on the child component that forwards the parent's ref to the child's DOM node.
+A veces, un componente padre debe establecer el foco en un elemento dentro de un componente hijo. Podemos hacer esto [exponiendo las referencias del DOM a los componentes padre](/docs/refs-and-the-dom.html#exposing-dom-refs-to-parent-components)
+a través de una prop especial en el componente hijo que envía la referencia del padre al nodo DOM del hijo.
 
 ```javascript{4,12,16}
 function CustomTextInput(props) {
@@ -225,21 +224,19 @@ class Parent extends React.Component {
   }
 }
 
-// Now you can set focus when required.
+// Ahora puedes establecer el foco cuando sea necesario.
 this.inputElement.current.focus();
 ```
 
-When using a HOC to extend components, it is recommended to [forward the ref](/docs/forwarding-refs.html) to the wrapped component using the `forwardRef` function of React. If a third party HOC
-does not implement ref forwarding, the above pattern can still be used as a fallback.
+Cuando se utiliza un HOC para extender componentes, se recomienda [reenviar la referencia](/docs/forwarding-refs.html) al componente envuelto usando la función `forwardRef` de React. Si un HOC de un tercero no implementa el reenvío de ref, el patrón anterior se puede utilizar como una alternativa de todas formas.
+
 
-A great focus management example is the [react-aria-modal](https://github.com/davidtheclark/react-aria-modal). This is a relatively rare example of a fully accessible modal window. Not only does it set initial focus on
-the cancel button (preventing the keyboard user from accidentally activating the success action) and trap keyboard focus inside the modal, it also resets focus back to the element that
-initially triggered the modal.
+Un gran ejemplo de gestión de foco es el [react-aria-modal](https://github.com/davidtheclark/react-aria-modal). Este es un ejemplo relativamente raro de una ventana modal totalmente accesible. No solo establece el foco inicial en el botón de cancelación (lo que evita que el usuario de teclado active accidentalmente la acción exitosa) y atrapa el foco del teclado dentro del modal, sino que también restablece el foco hacia el elemento que inicialmente activó el modal.
 
->Note:
+>Nota:
 >
->While this is a very important accessibility feature, it is also a technique that should be used judiciously. Use it to repair the keyboard focus flow when it is disturbed, not to try and anticipate how
->users want to use applications.
+>Si bien esta es una característica de accesibilidad muy importante, también es una técnica que debe usarse con prudencia. Úsalo para reparar el flujo de foco del teclado cuando está perturbado, no para intentar anticipar cómo 
+>los usuarios desean usar las aplicaciones.
 
 ## Mouse and pointer events {#mouse-and-pointer-events}
 

From 3b85099680fe4dc4cdd2b3f36b97d5e38c93ee58 Mon Sep 17 00:00:00 2001
From: Rodrigote <rodrigojali@gmail.com>
Date: Mon, 18 Feb 2019 21:27:04 -0300
Subject: [PATCH 3/5] Rodrigo Ali - Translation finished, ready for Code
 Review.

---
 content/docs/accessibility.md | 194 ++++++++++++++++------------------
 1 file changed, 92 insertions(+), 102 deletions(-)

diff --git a/content/docs/accessibility.md b/content/docs/accessibility.md
index d7cbe3c03..ce6278c34 100644
--- a/content/docs/accessibility.md
+++ b/content/docs/accessibility.md
@@ -238,16 +238,15 @@ Un gran ejemplo de gestión de foco es el [react-aria-modal](https://github.com/
 >Si bien esta es una característica de accesibilidad muy importante, también es una técnica que debe usarse con prudencia. Úsalo para reparar el flujo de foco del teclado cuando está perturbado, no para intentar anticipar cómo 
 >los usuarios desean usar las aplicaciones.
 
-## Mouse and pointer events {#mouse-and-pointer-events}
+## Eventos de ratón y puntero
 
-Ensure that all functionality exposed through a mouse or pointer event can also be accessed using the keyboard alone. Depending only on the pointer device will lead to many cases where
-keyboard users cannot use your application.
+Asegúrate que también se puede acceder a todas las funciones expuestas a través de un mouse o evento de puntero utilizando solo el teclado. Dependiendo solo del dispositivo puntero llevará a muchos casos donde Los usuarios de teclado no pueden usar tu aplicación.
 
-To illustrate this, let's look at a prolific example of broken accessibility caused by click events. This is the outside click pattern, where a user can disable an opened popover by clicking outside the element.
+Para ilustrar esto, veamos un ejemplo prolífico de accesibilidad rota causada por eventos de clic. Este es el patrón de clic externo, donde un usuario puede deshabilitar una ventana emergente abierta haciendo clic fuera del elemento.
 
 <img src="../images/docs/outerclick-with-mouse.gif" alt="A toggle button opening a popover list implemented with the click outside pattern and operated with a mouse showing that the close action works." />
 
-This is typically implemented by attaching a `click` event to the `window` object that closes the popover:
+Esto se implementa normalmente adjuntando un evento `click` al objeto` window` que cierra la ventana emergente:
 
 ```javascript{12-14,26-30}
 class OuterClickExample extends React.Component {
@@ -298,12 +297,11 @@ constructor(props) {
 }
 ```
 
-This may work fine for users with pointer devices, such as a mouse, but operating this with the keyboard alone leads to broken functionality when tabbing to the next element
-as the `window` object never receives a `click` event. This can lead to obscured functionality which blocks users from using your application.
+Esto puede funcionar bien para los usuarios con dispositivos de puntero, como un ratón, pero si lo hace solo con el teclado la funcionalidad se rompe al pasar al elemento siguiente, ya que el objeto `window` nunca recibe el evento` click`. Esto puede llevar a una funcionalidad oculta que impide que los usuarios utilicen su aplicación
 
 <img src="../images/docs/outerclick-with-keyboard.gif" alt="A toggle button opening a popover list implemented with the click outside pattern and operated with the keyboard showing the popover not being closed on blur and it obscuring other screen elements." />
 
-The same functionality can be achieved by using an appropriate event handlers instead, such as `onBlur` and `onFocus`:
+La misma funcionalidad se puede lograr utilizando un controlador de eventos apropiado, como `onBlur` y` onFocus`:
 
 ```javascript{19-29,31-34,37-38,40-41}
 class BlurExample extends React.Component {
@@ -324,10 +322,10 @@ class BlurExample extends React.Component {
     }));
   }
 
-  // We close the popover on the next tick by using setTimeout.
-  // This is necessary because we need to first check if
-  // another child of the element has received focus as
-  // the blur event fires prior to the new focus event.
+  // Cerramos la ventana emergente en el siguiente tick usando setTimeout.
+  // Esto es necesario porque primero debemos comprobar 
+  // si otro hijo del elemento ha recibido el foco ya que
+  // el evento de desenfoque se dispara antes del nuevo evento de foco.
   onBlurHandler() {
     this.timeOutId = setTimeout(() => {
       this.setState({
@@ -336,14 +334,14 @@ class BlurExample extends React.Component {
     });
   }
 
-  // If a child receives focus, do not close the popover.
+  // Si un hijo recibe el foco, no cerrar la ventana emergente.
   onFocusHandler() {
     clearTimeout(this.timeOutId);
   }
 
   render() {
-    // React assists us by bubbling the blur and
-    // focus events to the parent.
+    // React nos ayuda burbujeando los eventos de desenfoque
+    // y enfoque hacia los padres.
     return (
       <div onBlur={this.onBlurHandler}
            onFocus={this.onFocusHandler}>
@@ -365,86 +363,80 @@ class BlurExample extends React.Component {
 }
 ```
 
-This code exposes the functionality to both pointer device and keyboard users. Also note the added `aria-*` props to support screen-reader users. For simplicity's sake
-the keyboard events to enable `arrow key` interaction of the popover options have not been implemented.
+Este código expone la funcionalidad a los usuarios del dispositivo puntero y de teclado. También ten en cuenta las props `aria- *` para apoyar a los usuarios de lectores de pantalla. Por simplicidad, no se han implementado los eventos de teclado para habilitar la interacción `arrow key` de las opciones de ventanas emergentes.
 
 <img src="../images/docs/blur-popover-close.gif" alt="A popover list correctly closing for both mouse and keyboard users." />
 
-This is one example of many cases where depending on only pointer and mouse events will break functionality for keyboard users. Always testing with the keyboard will immediately
-highlight the problem areas which can then be fixed by using keyboard aware event handlers.
+Este es un ejemplo de muchos casos en los que, dependiendo de solo el puntero y el mouse, los eventos interrumpirán la funcionalidad para los usuarios de teclado. Probando siempre con el teclado resaltará de inmediato las áreas problemáticas que luego se pueden solucionar mediante el uso de controladores de eventos compatibles con el teclado.
 
-## More Complex Widgets {#more-complex-widgets}
+## Widgets más complejos
 
-A more complex user experience should not mean a less accessible one. Whereas accessibility is most easily achieved by coding as close to HTML as possible,
-even the most complex widget can be coded accessibly.
+Una experiencia de usuario más compleja no debe significar que sea menos accesible. Mientras que la accesibilidad se logra más fácilmente mediante la codificación lo más cerca posible de HTML, incluso el widget más complejo se puede codificar de manera accesible.
 
-Here we require knowledge of [ARIA Roles](https://www.w3.org/TR/wai-aria/#roles) as well as [ARIA States and Properties](https://www.w3.org/TR/wai-aria/#states_and_properties).
-These are toolboxes filled with HTML attributes that are fully supported in JSX and enable us to construct fully accessible, highly functional React components.
+Aquí requerimos conocimiento de [Roles de ARIA](https://www.w3.org/TR/wai-aria/#roles) así como [Estados y propiedades de ARIA](https://www.w3.org/TR/wai-aria/#states_and_properties).
+Estas son cajas de herramientas llenas de atributos HTML que son totalmente compatibles con JSX y nos permiten construir componentes React completamente accesibles y altamente funcionales.
 
-Each type of widget has a specific design pattern and is expected to function in a certain way by users and user agents alike:
+Cada tipo de widget tiene un patrón de diseño específico y se espera que funcione de una manera determinada por parte de usuarios y agentes de usuarios por igual:
 
-- [WAI-ARIA Authoring Practices - Design Patterns and Widgets](https://www.w3.org/TR/wai-aria-practices/#aria_ex)
-- [Heydon Pickering - ARIA Examples](http://heydonworks.com/practical_aria_examples/)
-- [Inclusive Components](https://inclusive-components.design/)
+- [Prácticas de autoría de WAI-ARIA - Patrones de diseño y widgets](https://www.w3.org/TR/wai-aria-practices/#aria_ex)
+- [Heydon Pickering - Ejemplos ARIA](http://heydonworks.com/practical_aria_examples/)
+- [Componentes Inclusivos](https://inclusive-components.design/)
 
-## Other Points for Consideration {#other-points-for-consideration}
+## Otros puntos a considerar
 
-### Setting the language {#setting-the-language}
+### Configurando el idioma
 
-Indicate the human language of page texts as screen reader software uses this to select the correct voice settings:
+Indique el idioma humano de los textos de la página, ya que el software del lector de pantalla lo utiliza para seleccionar la configuración de voz correcta:
 
-- [WebAIM - Document Language](http://webaim.org/techniques/screenreader/#language)
+- [WebAIM - Documento de lenguaje](http://webaim.org/techniques/screenreader/#language)
 
-### Setting the document title {#setting-the-document-title}
+### Configuración del título del documento
 
-Set the document `<title>` to correctly describe the current page content as this ensures that the user remains aware of the current page context:
+Configure el `<title>` del documento para que describa correctamente el contenido de la página actual, ya que esto garantiza que el usuario esté al tanto del contexto de la página actual:
 
-- [WCAG - Understanding the Document Title Requirement](https://www.w3.org/TR/UNDERSTANDING-WCAG20/navigation-mechanisms-title.html)
+- [WCAG - Comprendiendo el requisito del título del documento](https://www.w3.org/TR/UNDERSTANDING-WCAG20/navigation-mechanisms-title.html)
 
-We can set this in React using the [React Document Title Component](https://github.com/gaearon/react-document-title).
+Podemos configurar esto en React usando el [Componente Título del Documento de React](https://github.com/gaearon/react-document-title).
 
-### Color contrast {#color-contrast}
+### Contraste de color
 
-Ensure that all readable text on your website has sufficient color contrast to remain maximally readable by users with low vision:
+Asegúrese de que todo el texto legible en su sitio web tenga el contraste de color suficiente para que los usuarios con poca visión puedan leerlo al máximo:
 
-- [WCAG - Understanding the Color Contrast Requirement](https://www.w3.org/TR/UNDERSTANDING-WCAG20/visual-audio-contrast-contrast.html)
-- [Everything About Color Contrast And Why You Should Rethink It](https://www.smashingmagazine.com/2014/10/color-contrast-tips-and-tools-for-accessibility/)
-- [A11yProject - What is Color Contrast](http://a11yproject.com/posts/what-is-color-contrast/)
+- [WCAG - Comprender el requisito de contraste de color](https://www.w3.org/TR/UNDERSTANDING-WCAG20/visual-audio-contrast-contrast.html)
+- [Todo sobre el contraste de color y por qué debes repensarlo](https://www.smashingmagazine.com/2014/10/color-contrast-tips-and-tools-for-accessibility/)
+- [A11yProject - ¿Qué es el contraste de color?](http://a11yproject.com/posts/what-is-color-contrast/)
 
-It can be tedious to manually calculate the proper color combinations for all cases in your website so instead, you can [calculate an entire accessible color palette with Colorable](http://jxnblk.com/colorable/).
+Puede ser tedioso calcular manualmente las combinaciones de colores adecuadas para todos los casos en tu sitio web, por lo que puede [calcular una paleta de colores accesible completa con Colorable](http://jxnblk.com/colorable/).
 
-Both the aXe and WAVE tools mentioned below also include color contrast tests and will report on contrast errors.
+Tanto las herramientas aXe como WAVE que se mencionan a continuación también incluyen pruebas de contraste de color e informarán sobre errores de contraste.
 
-If you want to extend your contrast testing abilities you can use these tools:
+Si desea ampliar sus habilidades de prueba de contraste, puede utilizar estas herramientas:
 
-- [WebAIM - Color Contrast Checker](http://webaim.org/resources/contrastchecker/)
-- [The Paciello Group - Color Contrast Analyzer](https://www.paciellogroup.com/resources/contrastanalyser/)
+- [WebAIM - Comprobador de contraste de color](http://webaim.org/resources/contrastchecker/)
+- [El Grupo Paciello - Color Contrast Analyzer](https://www.paciellogroup.com/resources/contrastanalyser/)
 
-## Development and Testing Tools {#development-and-testing-tools}
+## Herramientas de desarrollo y pruebas
 
-There are a number of tools we can use to assist in the creation of accessible web applications.
+Hay una serie de herramientas que podemos utilizar para ayudar en la creación de aplicaciones web accesibles.
 
-### The keyboard {#the-keyboard}
+### El teclado
 
-By far the easiest and also one of the most important checks is to test if your entire website can be reached and used with the keyboard alone. Do this by:
+La comprobación más fácil y también una de las más importantes es, por mucho, comprobar si se puede acceder a todo el sitio web y usarlo solo con el teclado. Hágalo de la siguiente forma:
 
-1. Plugging out your mouse.
-1. Using `Tab` and `Shift+Tab` to browse.
-1. Using `Enter` to activate elements.
-1. Where required, using your keyboard arrow keys to interact with some elements, such as menus and dropdowns.
+1. Desconectando su ratón.
+1. Usando `Tab` y `Shift + Tab` para navegar.
+1. Usando `Enter` para activar elementos.
+1. Cuando sea necesario, utilice las teclas de flecha del teclado para interactuar con algunos elementos, como menús y menús desplegables.
 
-### Development assistance {#development-assistance}
+### Asistencia para el desarrollo
 
-We can check some accessibility features directly in our JSX code. Often intellisense checks are already provided in JSX aware IDE's for the ARIA roles, states and properties. We also
-have access to the following tool:
+Podemos verificar algunas funciones de accesibilidad directamente en nuestro código JSX. A menudo, las comprobaciones de intellisense para roles, estados y propiedades ARIA ya son proporcinadas en IDE's preparados para JSX. También tenemos acceso a la siguiente herramienta:
 
-#### eslint-plugin-jsx-a11y {#eslint-plugin-jsx-a11y}
+#### eslint-plugin-jsx-a11y
 
-The [eslint-plugin-jsx-a11y](https://github.com/evcohen/eslint-plugin-jsx-a11y) plugin for ESLint provides AST linting feedback regarding accessibility issues in your JSX. Many
-IDE's allow you to integrate these findings directly into code analysis and source code windows.
+El complemento [eslint-plugin-jsx-a11y] (https://github.com/evcohen/eslint-plugin-jsx-a11y) para ESLint proporciona linting de AST sobre los problemas de accesibilidad en tu JSX. Muchos IDE's te permiten integrar estos hallazgos directamente en el análisis de código y las ventanas de código fuente.
 
-[Create React App](https://github.com/facebookincubator/create-react-app) has this plugin with a subset of rules activated. If you want to enable even more accessibility rules,
-you can create an `.eslintrc` file in the root of your project with this content:
+[Create React App](https://github.com/facebookincubator/create-react-app) tiene este complemento con un subconjunto de reglas activadas. Si desea habilitar aún más reglas de accesibilidad, puede crear un archivo `.eslintrc` en la raíz de su proyecto con este contenido:
 
   ```json
   {
@@ -453,77 +445,75 @@ you can create an `.eslintrc` file in the root of your project with this content
   }
   ```
 
-### Testing accessibility in the browser {#testing-accessibility-in-the-browser}
+### Probando accesibilidad en el navegador.
 
-A number of tools exist that can run accessibility audits on web pages in your browser. Please use them in combination with other accessibility checks mentioned here as they can only
-test the technical accessibility of your HTML.
+Existen varias herramientas que pueden ejecutar auditorías de accesibilidad en las páginas web de su navegador. Utilízalas en combinación con otras comprobaciones de accesibilidad que se mencionan aquí, ya que solo pueden probar la accesibilidad técnica de su HTML.
 
-#### aXe, aXe-core and react-axe {#axe-axe-core-and-react-axe}
+#### aXe, aXe-core y react-axe
 
 Deque Systems offers [aXe-core](https://github.com/dequelabs/axe-core) for automated and end-to-end accessibility tests of your applications. This module includes integrations for Selenium.
 
-[The Accessibility Engine](https://www.deque.com/products/axe/) or aXe, is an accessibility inspector browser extension built on `aXe-core`.
+[El Motor de Accesibilidad](https://www.deque.com/products/axe/) o aXe (por sus siglas en inglés), es una extensión inspectora de accesibilidad del navegador construida sobre `aXe-core`.
 
-You can also use the [react-axe](https://github.com/dylanb/react-axe) module to report these accessibility findings directly to the console while developing and debugging.
+También puede usar el módulo [react-axe](https://github.com/dylanb/react-axe) para informar estos hallazgos de accesibilidad directamente a la consola mientras desarrolla y depura.
 
-#### WebAIM WAVE {#webaim-wave}
+#### WebAIM WAVE
 
-The [Web Accessibility Evaluation Tool](http://wave.webaim.org/extension/) is another accessibility browser extension.
+La [Herramienta de evaluación de accesibilidad web](http://wave.webaim.org/extension/) (WAVE por sus siglas en inglés) es otra extensión de accesibilidad del navegador.
 
-#### Accessibility inspectors and the Accessibility Tree {#accessibility-inspectors-and-the-accessibility-tree}
+#### Inspectores de accesibilidad y el Árbol de Accesibilidad
 
-[The Accessibility Tree](https://www.paciellogroup.com/blog/2015/01/the-browser-accessibility-tree/) is a subset of the DOM tree that contains accessible objects for every DOM element that should be exposed
-to assistive technology, such as screen readers.
+[El Árbol de Accesibilidad](https://www.paciellogroup.com/blog/2015/01/the-browser-accessibility-tree/) es un subconjunto del árbol DOM que contiene objetos accesibles para cada elemento del DOM que debería ser expuesto a la tecnología de asistencia, como los lectores de pantalla.
 
-In some browsers we can easily view the accessibility information for each element in the accessibility tree:
+En algunos navegadores podemos ver fácilmente la información de accesibilidad para cada elemento en el árbol de accesibilidad:
 
-- [Using the Accessibility Inspector in Firefox](https://developer.mozilla.org/en-US/docs/Tools/Accessibility_inspector)
-- [Activate the Accessibility Inspector in Chrome](https://gist.github.com/marcysutton/0a42f815878c159517a55e6652e3b23a)
-- [Using the Accessibility Inspector in OS X Safari](https://developer.apple.com/library/content/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXTestingApps.html)
+- [Usando el inspector de accesibilidad en Firefox](https://developer.mozilla.org/en-US/docs/Tools/Accessibility_inspector)
+- [Activar el inspector de accesibilidad en Chrome](https://gist.github.com/marcysutton/0a42f815878c159517a55e6652e3b23a)
+- [Usando el inspector de accesibilidad en OS X Safari](https://developer.apple.com/library/content/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXTestingApps.html)
 
-### Screen readers {#screen-readers}
+### Lectores de pantalla
 
-Testing with a screen reader should form part of your accessibility tests.
+Las pruebas con un lector de pantalla deben formar parte de sus pruebas de accesibilidad.
 
-Please note that browser / screen reader combinations matter. It is recommended that you test your application in the browser best suited to your screen reader of choice.
+Tenga en cuenta que las combinaciones de navegador / lector de pantalla son importantes. Se recomienda que pruebe su aplicación en el navegador que mejor se adapte a su lector de pantalla.
 
-### Commonly Used Screen Readers {#commonly-used-screen-readers}
+### Lectores de pantalla de uso común
 
-#### NVDA in Firefox {#nvda-in-firefox}
+#### NVDA en Firefox
 
-[NonVisual Desktop Access](https://www.nvaccess.org/) or NVDA is an open source Windows screen reader that is widely used.
+[Acceso a Escritorio No Visual](https://www.nvaccess.org/) o NVDA  por sus siglas en inglés, es un lector de pantalla de Windows de código abierto que es ampliamente usado.
 
-Refer to the following guides on how to best use NVDA:
+Consulte las siguientes guías sobre cómo utilizar mejor NVDA:
 
-- [WebAIM - Using NVDA to Evaluate Web Accessibility](http://webaim.org/articles/nvda/)
-- [Deque - NVDA Keyboard Shortcuts](https://dequeuniversity.com/screenreaders/nvda-keyboard-shortcuts)
+- [WebAIM - Usando NVDA para evaluar la accesibilidad web](http://webaim.org/articles/nvda/)
+- [Deque - Atajos de teclado NVDA](https://dequeuniversity.com/screenreaders/nvda-keyboard-shortcuts)
 
-#### VoiceOver in Safari {#voiceover-in-safari}
+#### VoiceOver en Safari
 
-VoiceOver is an integrated screen reader on Apple devices.
+VoiceOver es un lector de pantalla integrado en dispositivos Apple.
 
-Refer to the following guides on how activate and use VoiceOver:
+Consulte las siguientes guías sobre cómo activar y usar VoiceOver:
 
-- [WebAIM - Using VoiceOver to Evaluate Web Accessibility](http://webaim.org/articles/voiceover/)
-- [Deque - VoiceOver for OS X Keyboard Shortcuts](https://dequeuniversity.com/screenreaders/voiceover-keyboard-shortcuts)
-- [Deque - VoiceOver for iOS Shortcuts](https://dequeuniversity.com/screenreaders/voiceover-ios-shortcuts)
+- [WebAIM - Uso de VoiceOver para evaluar la accesibilidad web](http://webaim.org/articles/voiceover/)
+- [Deque - VoiceOver para los atajos de teclado de OS X](https://dequeuniversity.com/screenreaders/voiceover-keyboard-shortcuts)
+- [Deque - VoiceOver para accesos directos de iOS](https://dequeuniversity.com/screenreaders/voiceover-ios-shortcuts)
 
-#### JAWS in Internet Explorer {#jaws-in-internet-explorer}
+#### JAWS en Internet Explorer
 
-[Job Access With Speech](http://www.freedomscientific.com/Products/Blindness/JAWS) or JAWS, is a prolifically used screen reader on Windows.
+[Acceso al Trabajo con el Habla](http://www.freedomscientific.com/Products/Blindness/JAWS) o JAWS por sus siglas en inglés, es un lector de pantalla de uso prolífico en Windows.
 
-Refer to the following guides on how to best use JAWS:
+Consulte las siguientes guías sobre cómo utilizar mejor JAWS:
 
-- [WebAIM - Using JAWS to Evaluate Web Accessibility](http://webaim.org/articles/jaws/)
-- [Deque - JAWS Keyboard Shortcuts](https://dequeuniversity.com/screenreaders/jaws-keyboard-shortcuts)
+- [WebAIM - Uso de JAWS para evaluar la accesibilidad web](http://webaim.org/articles/jaws/)
+- [Deque - Atajos de teclado de JAWS](https://dequeuniversity.com/screenreaders/jaws-keyboard-shortcuts)
 
-### Other Screen Readers {#other-screen-readers}
+### Otros lectores de pantalla
 
-#### ChromeVox in Google Chrome {#chromevox-in-google-chrome}
+#### ChromeVox en Google Chrome
 
-[ChromeVox](http://www.chromevox.com/) is an integrated screen reader on Chromebooks and is available [as an extension](https://chrome.google.com/webstore/detail/chromevox/kgejglhpjiefppelpmljglcjbhoiplfn?hl=en) for Google Chrome.
+[ChromeVox](http://www.chromevox.com/) es un lector de pantalla integrado en Chromebooks y está disponible [como una extensión](https://chrome.google.com/webstore/detail/chromevox/kgejglhpjiefppelpmljglcjbhoiplfn?hl=es) para Google Chrome.
 
 Refer to the following guides on how best to use ChromeVox:
 
-- [Google Chromebook Help - Use the Built-in Screen Reader](https://support.google.com/chromebook/answer/7031755?hl=en)
-- [ChromeVox Classic Keyboard Shortcuts Reference](http://www.chromevox.com/keyboard_shortcuts.html)
+- [Ayuda de Google Chromebook - Usa el lector de pantalla incorporado](https://support.google.com/chromebook/answer/7031755?hl=es)
+- [Referencia de accesos directos del teclado clásico de ChromeVox](http://www.chromevox.com/keyboard_shortcuts.html)

From 9446acf485ea763f702af23e101b34f1bab81ddf Mon Sep 17 00:00:00 2001
From: Rodrigote <rodrigojali@gmail.com>
Date: Wed, 20 Feb 2019 22:21:07 -0300
Subject: [PATCH 4/5] Rodrigo Ali - Addressing PR comments: minor orthographic
 corrections, adding deleted IDs.

---
 content/docs/accessibility.md | 70 +++++++++++++++++------------------
 1 file changed, 35 insertions(+), 35 deletions(-)

diff --git a/content/docs/accessibility.md b/content/docs/accessibility.md
index ce6278c34..86a98f570 100644
--- a/content/docs/accessibility.md
+++ b/content/docs/accessibility.md
@@ -4,13 +4,13 @@ title: Accesibilidad
 permalink: docs/accessibility.html
 ---
 
-## ¿Por qué Accesibilidad?
+## ¿Por qué Accesibilidad? {#why-accessibility}
 
-La accesibilidad web (también conocida como [** a11y **] (https://en.wiktionary.org/wiki/a11y)) es el diseño y la creación de sitios web que pueden ser utilizados por todos. El soporte de accesibilidad es necesario para permitir que la tecnología de asistencia interprete las páginas web.
+La accesibilidad web (también conocida como [**a11y**](https://en.wiktionary.org/wiki/a11y)) es el diseño y la creación de sitios web que pueden ser utilizados por todos. El soporte de accesibilidad es necesario para permitir que la tecnología de asistencia interprete las páginas web.
 
 React es totalmente compatible con la creación de sitios web accesibles, a menudo mediante el uso de técnicas estándar de HTML.
 
-## Normas y lineamientos
+## Normas y lineamientos {#standards-and-guidelines}
 
 ### WCAG {#wcag}
 
@@ -26,7 +26,7 @@ Las siguientes listas de verificación WCAG proporcionan una visión general:
 
 El documento [Iniciativa de Accesibilidad Web - Aplicaciones de Internet Enriquecidas y Accesibles (WAI-ARIA por sus siglas en inglés)](https://www.w3.org/WAI/intro/aria) contiene técnicas para construir widgets de JavaScript totalmente accesibles.
 
-Tenga en cuenta que todos los atributos HTML `aria- *` son totalmente compatibles con JSX. Mientras que la mayoría de las propiedades y atributos de DOM en React son camelCase, estos atributos deben tener un guión (también conocido como kebab-case, lisp-case, etc.) ya que están en HTML simple:
+Ten en cuenta que todos los atributos HTML `aria- *` son totalmente compatibles con JSX. Mientras que la mayoría de las propiedades y atributos de DOM en React son camelCase, estos atributos deben tener un guión (también conocido como kebab-case, lisp-case, etc.) ya que están en HTML simple:
 
 ```javascript{3,4}
 <input
@@ -39,7 +39,7 @@ Tenga en cuenta que todos los atributos HTML `aria- *` son totalmente compatible
 />
 ```
 
-## HTML semnántico
+## HTML semántico {#semantic-html}
 
 El HTML semántico es la base de la accesibilidad en una aplicación web. Haciendo uso de los diversos elementos HTML para reforzar el significado de la información en nuestros sitios web a menudo nos dará accesibilidad de forma gratuita.
 
@@ -106,9 +106,9 @@ function ListItem({ item }) {
 
 Para más información, consulta [la documentación de Fragmentos](/docs/fragments.html).
 
-## Formularios accesibles
+## Formularios accesibles {#accessible-forms}
 
-### Etiquetado
+### Etiquetado {#labeling}
 
 Todos los controles de formulario HTML, como `<input>` y `<textarea>`, deben ser etiquetados de forma accesible. Necesitamos proporcionar etiquetas descriptivas que también estén expuestas a los lectores de pantalla.
 
@@ -125,20 +125,20 @@ Aunque estas prácticas estándar de HTML se pueden usar directamente en React,
 <input id="namedInput" type="text" name="name"/>
 ```
 
-### Notificando errores al usuario
+### Notificando errores al usuario {#notifying-the-user-of-errors}
 
 Las situaciones de error deben ser entendidas por todos los usuarios. El siguiente enlace también nos muestra cómo exponer textos de error a lectores de pantalla:
 
 - [El W3C demuestra notificaciones de usuario](https://www.w3.org/WAI/tutorials/forms/notifications/)
 - [WebAIM analiza la validación de formularios](http://webaim.org/techniques/formvalidation/)
 
-## Control de foco
+## Control de foco {#focus-control}
 
 Asegúrese de que su aplicación web pueda ser operada completamente solo con el teclado:
 
 - [WebAIM habla sobre accesibilidad de teclado](http://webaim.org/techniques/keyboard/)
 
-### Foco de teclado y contorno de foco
+### Foco de teclado y contorno de foco {#keyboard-focus-and-focus-outline}
 
 El foco del teclado se refiere al elemento actual en el DOM que está seleccionado para aceptar la entrada desde el teclado. Lo vemos en todas partes como un contorno de foco similar al que se muestra en la siguiente imagen:
 
@@ -146,7 +146,7 @@ El foco del teclado se refiere al elemento actual en el DOM que está selecciona
 
 Solamente use CSS que elimine este contorno, por ejemplo, configurando `outline: 0`, si lo va a reemplazar por otra implementación de contorno de foco.
 
-### Mecanismos para omitir hacia el contenido deseado.
+### Mecanismos para omitir hacia el contenido deseado. {#mechanisms-to-skip-to-desired-content}
 
 Proporcione un mecanismo para permitir que los usuarios omitan las secciones de navegación en su aplicación, ya que esto ayuda y acelera la navegación con el teclado.
 
@@ -160,7 +160,7 @@ Lea más sobre el uso de estos elementos para mejorar la accesibilidad aquí:
 
 - [Puntos de referencia accesibles](http://www.scottohara.me/blog/2018/03/03/landmarks.html)
 
-### Gestionando programáticamente el foco.
+### Gestionando programáticamente el foco. {#programmatically-managing-focus}
 
 Nuestras aplicaciones React modifican continuamente el DOM de HTML durante el tiempo de ejecución, lo que a veces hace que el foco del teclado se pierda o se establezca en un elemento inesperado. Para reparar esto, tenemos que empujar programáticamente el foco del teclado en la dirección correcta. Por ejemplo, al restablecer el foco del teclado a un botón que abrió una ventana modal después de que se cierre esa ventana modal.
 
@@ -238,7 +238,7 @@ Un gran ejemplo de gestión de foco es el [react-aria-modal](https://github.com/
 >Si bien esta es una característica de accesibilidad muy importante, también es una técnica que debe usarse con prudencia. Úsalo para reparar el flujo de foco del teclado cuando está perturbado, no para intentar anticipar cómo 
 >los usuarios desean usar las aplicaciones.
 
-## Eventos de ratón y puntero
+## Eventos de ratón y puntero {#mouse-and-pointer-events}
 
 Asegúrate que también se puede acceder a todas las funciones expuestas a través de un mouse o evento de puntero utilizando solo el teclado. Dependiendo solo del dispositivo puntero llevará a muchos casos donde Los usuarios de teclado no pueden usar tu aplicación.
 
@@ -369,7 +369,7 @@ Este código expone la funcionalidad a los usuarios del dispositivo puntero y de
 
 Este es un ejemplo de muchos casos en los que, dependiendo de solo el puntero y el mouse, los eventos interrumpirán la funcionalidad para los usuarios de teclado. Probando siempre con el teclado resaltará de inmediato las áreas problemáticas que luego se pueden solucionar mediante el uso de controladores de eventos compatibles con el teclado.
 
-## Widgets más complejos
+## Widgets más complejos {#more-complex-widgets}
 
 Una experiencia de usuario más compleja no debe significar que sea menos accesible. Mientras que la accesibilidad se logra más fácilmente mediante la codificación lo más cerca posible de HTML, incluso el widget más complejo se puede codificar de manera accesible.
 
@@ -382,15 +382,15 @@ Cada tipo de widget tiene un patrón de diseño específico y se espera que func
 - [Heydon Pickering - Ejemplos ARIA](http://heydonworks.com/practical_aria_examples/)
 - [Componentes Inclusivos](https://inclusive-components.design/)
 
-## Otros puntos a considerar
+## Otros puntos a considerar {#other-points-for-consideration}
 
-### Configurando el idioma
+### Configurando el idioma {#setting-the-language}
 
 Indique el idioma humano de los textos de la página, ya que el software del lector de pantalla lo utiliza para seleccionar la configuración de voz correcta:
 
 - [WebAIM - Documento de lenguaje](http://webaim.org/techniques/screenreader/#language)
 
-### Configuración del título del documento
+### Configuración del título del documento {#setting-the-document-title}
 
 Configure el `<title>` del documento para que describa correctamente el contenido de la página actual, ya que esto garantiza que el usuario esté al tanto del contexto de la página actual:
 
@@ -398,7 +398,7 @@ Configure el `<title>` del documento para que describa correctamente el contenid
 
 Podemos configurar esto en React usando el [Componente Título del Documento de React](https://github.com/gaearon/react-document-title).
 
-### Contraste de color
+### Contraste de color {#color-contrast}
 
 Asegúrese de que todo el texto legible en su sitio web tenga el contraste de color suficiente para que los usuarios con poca visión puedan leerlo al máximo:
 
@@ -415,11 +415,11 @@ Si desea ampliar sus habilidades de prueba de contraste, puede utilizar estas he
 - [WebAIM - Comprobador de contraste de color](http://webaim.org/resources/contrastchecker/)
 - [El Grupo Paciello - Color Contrast Analyzer](https://www.paciellogroup.com/resources/contrastanalyser/)
 
-## Herramientas de desarrollo y pruebas
+## Herramientas de desarrollo y pruebas {#development-and-testing-tools}
 
 Hay una serie de herramientas que podemos utilizar para ayudar en la creación de aplicaciones web accesibles.
 
-### El teclado
+### El teclado {#the-keyboard}
 
 La comprobación más fácil y también una de las más importantes es, por mucho, comprobar si se puede acceder a todo el sitio web y usarlo solo con el teclado. Hágalo de la siguiente forma:
 
@@ -428,11 +428,11 @@ La comprobación más fácil y también una de las más importantes es, por much
 1. Usando `Enter` para activar elementos.
 1. Cuando sea necesario, utilice las teclas de flecha del teclado para interactuar con algunos elementos, como menús y menús desplegables.
 
-### Asistencia para el desarrollo
+### Asistencia para el desarrollo {#development-assistance}
 
-Podemos verificar algunas funciones de accesibilidad directamente en nuestro código JSX. A menudo, las comprobaciones de intellisense para roles, estados y propiedades ARIA ya son proporcinadas en IDE's preparados para JSX. También tenemos acceso a la siguiente herramienta:
+Podemos verificar algunas funciones de accesibilidad directamente en nuestro código JSX. A menudo, las comprobaciones de intellisense para roles, estados y propiedades ARIA ya son proporcionadas en IDE's preparados para JSX. También tenemos acceso a la siguiente herramienta:
 
-#### eslint-plugin-jsx-a11y
+#### eslint-plugin-jsx-a11y {#eslint-plugin-jsx-a11y}
 
 El complemento [eslint-plugin-jsx-a11y] (https://github.com/evcohen/eslint-plugin-jsx-a11y) para ESLint proporciona linting de AST sobre los problemas de accesibilidad en tu JSX. Muchos IDE's te permiten integrar estos hallazgos directamente en el análisis de código y las ventanas de código fuente.
 
@@ -445,11 +445,11 @@ El complemento [eslint-plugin-jsx-a11y] (https://github.com/evcohen/eslint-plugi
   }
   ```
 
-### Probando accesibilidad en el navegador.
+### Probando accesibilidad en el navegador. {#testing-accessibility-in-the-browser}
 
 Existen varias herramientas que pueden ejecutar auditorías de accesibilidad en las páginas web de su navegador. Utilízalas en combinación con otras comprobaciones de accesibilidad que se mencionan aquí, ya que solo pueden probar la accesibilidad técnica de su HTML.
 
-#### aXe, aXe-core y react-axe
+#### aXe, aXe-core y react-axe {#axe-axe-core-and-react-axe}
 
 Deque Systems offers [aXe-core](https://github.com/dequelabs/axe-core) for automated and end-to-end accessibility tests of your applications. This module includes integrations for Selenium.
 
@@ -457,11 +457,11 @@ Deque Systems offers [aXe-core](https://github.com/dequelabs/axe-core) for autom
 
 También puede usar el módulo [react-axe](https://github.com/dylanb/react-axe) para informar estos hallazgos de accesibilidad directamente a la consola mientras desarrolla y depura.
 
-#### WebAIM WAVE
+#### WebAIM WAVE {#webaim-wave}
 
 La [Herramienta de evaluación de accesibilidad web](http://wave.webaim.org/extension/) (WAVE por sus siglas en inglés) es otra extensión de accesibilidad del navegador.
 
-#### Inspectores de accesibilidad y el Árbol de Accesibilidad
+#### Inspectores de accesibilidad y el Árbol de Accesibilidad {#accessibility-inspectors-and-the-accessibility-tree}
 
 [El Árbol de Accesibilidad](https://www.paciellogroup.com/blog/2015/01/the-browser-accessibility-tree/) es un subconjunto del árbol DOM que contiene objetos accesibles para cada elemento del DOM que debería ser expuesto a la tecnología de asistencia, como los lectores de pantalla.
 
@@ -471,15 +471,15 @@ En algunos navegadores podemos ver fácilmente la información de accesibilidad
 - [Activar el inspector de accesibilidad en Chrome](https://gist.github.com/marcysutton/0a42f815878c159517a55e6652e3b23a)
 - [Usando el inspector de accesibilidad en OS X Safari](https://developer.apple.com/library/content/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXTestingApps.html)
 
-### Lectores de pantalla
+### Lectores de pantalla {#screen-readers}
 
 Las pruebas con un lector de pantalla deben formar parte de sus pruebas de accesibilidad.
 
-Tenga en cuenta que las combinaciones de navegador / lector de pantalla son importantes. Se recomienda que pruebe su aplicación en el navegador que mejor se adapte a su lector de pantalla.
+Ten en cuenta que las combinaciones de navegador / lector de pantalla son importantes. Se recomienda que pruebe su aplicación en el navegador que mejor se adapte a su lector de pantalla.
 
-### Lectores de pantalla de uso común
+### Lectores de pantalla de uso común {#commonly-used-screen-readers}
 
-#### NVDA en Firefox
+#### NVDA en Firefox {#nvda-in-firefox}
 
 [Acceso a Escritorio No Visual](https://www.nvaccess.org/) o NVDA  por sus siglas en inglés, es un lector de pantalla de Windows de código abierto que es ampliamente usado.
 
@@ -488,7 +488,7 @@ Consulte las siguientes guías sobre cómo utilizar mejor NVDA:
 - [WebAIM - Usando NVDA para evaluar la accesibilidad web](http://webaim.org/articles/nvda/)
 - [Deque - Atajos de teclado NVDA](https://dequeuniversity.com/screenreaders/nvda-keyboard-shortcuts)
 
-#### VoiceOver en Safari
+#### VoiceOver en Safari {#voiceover-in-safari}
 
 VoiceOver es un lector de pantalla integrado en dispositivos Apple.
 
@@ -498,7 +498,7 @@ Consulte las siguientes guías sobre cómo activar y usar VoiceOver:
 - [Deque - VoiceOver para los atajos de teclado de OS X](https://dequeuniversity.com/screenreaders/voiceover-keyboard-shortcuts)
 - [Deque - VoiceOver para accesos directos de iOS](https://dequeuniversity.com/screenreaders/voiceover-ios-shortcuts)
 
-#### JAWS en Internet Explorer
+#### JAWS en Internet Explorer {#jaws-in-internet-explorer}
 
 [Acceso al Trabajo con el Habla](http://www.freedomscientific.com/Products/Blindness/JAWS) o JAWS por sus siglas en inglés, es un lector de pantalla de uso prolífico en Windows.
 
@@ -507,9 +507,9 @@ Consulte las siguientes guías sobre cómo utilizar mejor JAWS:
 - [WebAIM - Uso de JAWS para evaluar la accesibilidad web](http://webaim.org/articles/jaws/)
 - [Deque - Atajos de teclado de JAWS](https://dequeuniversity.com/screenreaders/jaws-keyboard-shortcuts)
 
-### Otros lectores de pantalla
+### Otros lectores de pantalla {#other-screen-readers}
 
-#### ChromeVox en Google Chrome
+#### ChromeVox en Google Chrome {#chromevox-in-google-chrome}
 
 [ChromeVox](http://www.chromevox.com/) es un lector de pantalla integrado en Chromebooks y está disponible [como una extensión](https://chrome.google.com/webstore/detail/chromevox/kgejglhpjiefppelpmljglcjbhoiplfn?hl=es) para Google Chrome.
 

From feb73b6ac760e0bc5a199379309ec6bf919400f9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Alejandro=20=C3=91=C3=A1=C3=B1ez=20Ortiz?=
 <alejonanez@gmail.com>
Date: Sat, 23 Feb 2019 14:24:20 -0500
Subject: [PATCH 5/5] Update accessibility.md

---
 content/docs/accessibility.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/content/docs/accessibility.md b/content/docs/accessibility.md
index 695468772..86a98f570 100644
--- a/content/docs/accessibility.md
+++ b/content/docs/accessibility.md
@@ -152,7 +152,6 @@ Proporcione un mecanismo para permitir que los usuarios omitan las secciones de
 
 Skiplink o Skip Navigation son enlaces de navegación ocultos que solo se hacen visibles cuando los usuarios de teclado interactúan con la página. Son muy fáciles de implementar con anclajes internos de página y algunos estilos:
 
-
 - [WebAIM - Omitir enlaces de navegación](http://webaim.org/techniques/skipnav/)
 
 También utilice elementos y roles de puntos de referencia, como `<main>` y `<aside>`, para delimitar las regiones de la página ya que la tecnología de asistencia permite al usuario navegar rápidamente a estas secciones.