Add docs/chrome/desarrolladores/biseccion.md
Change-Id: I7971fcb374ff170b7ddb9e62fc868ecf4e3e9f7d
diff --git a/docs/chrome/desarrolladores/biseccion.md b/docs/chrome/desarrolladores/biseccion.md
new file mode 100644
index 0000000..38983df
--- /dev/null
+++ b/docs/chrome/desarrolladores/biseccion.md
@@ -0,0 +1,84 @@
+# Cómo hacer una bisección de Chromium
+
+¿Alguna vez has visto un bug de tipo "regresión" como el siguiente? "_En
+Chromium 86.0.4240.193, esto falla. Pero si me voy atrás y uso Chromium
+85.0.4183.121, todo funciona bien_". Una buena manera de diagnosticar bugs
+como estos –donde no está claro qué cambio podría haber causado la regresión,
+pero puedes reproducir consistentemente el problema en una versión nueva,
+pero no en una antigua– es hacer una **bisección**.
+
+!!! info "¿Qué es Chromium?"
+ Chromium es el navegador en el que se basa Chrome. Chromium es un navegador
+ de código abierto (su código se puede leer por cualquier persona y cualquier
+ persona puede contribuir cambios), al contrario de Chrome, que es una
+ versión de Chromium personalizada por Google con más funciones (y el código
+ de estas no es accesible).
+
+ En resumen: _Chrome = Chromium + modificaciones de Google_.
+
+ En realidad, Chromium y Chrome son casi idénticos, puesto que las
+ modificaciones son pocas, pero una de las cosas relevantes es que las
+ versiones antiguas de Chromium se pueden descargar, mientras que Google no
+ ofrece enlaces de descarga de las versiones antiguas de Chrome.
+
+ Así pues, podemos hacer la bisección con Chromium, pero no con Chrome.
+
+## Instrucciones para hacer la bisección
+
+Para hacer una bisección, sigue los siguientes pasos:
+
+1. Abre la terminal.
+2. Dependiendo de tu sistema operativo, ejecuta uno de los siguientes
+ comandos, que descargará la herramienta de bisección en la carpeta actual:
+ - **Linux**: `curl -s --basic -n "https://chromium.googlesource.com/chromium/src/+/master/tools/bisect-builds.py?format=TEXT" | base64 -d > bisect-builds.py`
+ - **macOS**: `curl -s --basic -n "https://chromium.googlesource.com/chromium/src/+/master/tools/bisect-builds.py?format=TEXT" | base64 -D > bisect-builds.py`
+ - **Windows**: `python -c "import urllib2; import base64; print base64.b64decode(urllib2.urlopen(\"https://chromium.googlesource.com/chromium/src/+/master/tools/bisect-builds.py?format=TEXT\").read())" > bisect-builds.py`
+3. Ahora, ejecuta el siguiente comando:
+ `python bisect-builds.py -a plataforma -g versión_buena -b versión_mala
+ --verify-range`
+ - Debes sustituir `plataforma` por tu sistema operativo: `mac64`, `win64`,
+ `linux64` o `linuxarm` (en el caso que tu sistema sea de 32-bits, debes
+ poner `mac`, `win` o `linux`).
+ - Debes sustituir `versión_buena` por una versión antigua que funcionaba
+ correctamente y `versión_mala` por una versión nueva donde ya no funciona
+ correctamente. Puede ser una versión específica como por ejemplo
+ `87.0.4280.67`, o `M86` para referirse a la última versión de Chromium 86.
+4. Al ejecutarlo, la herramienta empezará a descargarse una lista de versiones
+ que existen entre las dos que le hemos dado. Luego, nos hará seguir los
+ siguientes pasos repetidamente:
+ 1. Aparece `Trying revision {número}...` en la terminal y se abre una
+ ventana de Chromium.
+ 2. Ahora, debemos intentar reproducir el error en la ventana de Chromium
+ que se ha abierto.
+ 3. Una vez hayamos comprobado si el problema existe en esa versión o no,
+ cerramos la ventana de Chromium.
+ 4. En la terminal ahora aparecerá el mensaje `Revision {número} is
+ [(g)ood/(b)ad/(r)etry/(u)nknown/(s)tdout/(q)uit]:`. Debemos introducir
+ una de las siguientes letras y pulsar enter para indicar a la
+ herramienta cómo ha ido la prueba:
+ - **g** (_good_, en español: buena): esta versión era buena, es decir,
+ el problema **no** está presente en esta versión.
+ - **b** (_bad_, en español: mala): esta versión era mala, es decir, el
+ problema está presente en esta versión.
+ - **r** (_retry_, en español: reintentar): vuelve a abrir la ventana de
+ Chromium de esta versión para que puedas volver a probar.
+ - **u** (_unknown_, en español: no conocido): no sabes si en esta
+ versión se encuentra el problema o no.
+ 5. Se repetirá esto unas cuantas veces (puedes ver que en la
+ terminal aparece `roughly {n} steps lefs`, donde `{n}` es el número
+ de pasos que quedan por terminar aproximadamente).
+5. Una vez terminado, aparecerá un texto parecido al siguiente:
+
+```
+You are probably looking for a change made after 384820 (known good), but no later than 384821 (first known bad).
+CHANGELOG URL:
+https://chromium.googlesource.com/chromium/src/+log/a7afaf4f40dd9febabd6a0ebcfa1fdc9e1a890ea..f217f60c51bed92efd5cba86860a7a9909148c61
+```
+
+Esto es justamente lo relevante: da las dos revisiones donde se produce el
+cambio que genera el error (en este caso el cambio de `384820` a `384821`) y una
+URL donde se pueden ver todos los cambios hechos entre estas dos revisiones.
+
+---
+
+_Este documento es una traducción y adaptación del documento [https://www.chromium.org/developers/bisect-builds-py](https://www.chromium.org/developers/bisect-builds-py), disponible bajo la licencia [Creative Commons Attribution 2.5](https://creativecommons.org/licenses/by/2.5/) (The Chromium Authors)_
diff --git a/mkdocs.yml b/mkdocs.yml
index 3db5dc2..7136622 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -32,6 +32,7 @@
- 'Descarte y recarga de pestañas': 'chrome/traducciones/descarte-recarga-pestanas.md'
- 'Ataques locales en Chrome': 'chrome/traducciones/ataques-locales-chrome.md'
- 'Para desarrolladores':
+ - 'Hacer una bisección de Chrome': 'chrome/desarrolladores/biseccion.md'
- 'Vida de un objeto URLRequest': 'chrome/desarrolladores/vida-de-una-url-request.md'
- 'Un curso rápido sobre diagnóstico de problemas con chrome://net-internals': 'chrome/desarrolladores/curso-diagnostico-net-internals.md'
- 'Gmail':