Si. El archivo tiene que tener extensión .rst para que funcione

@humitos no tengo muy claro porque falla el build.... es por este mensaje?

checking consistency... cpython/Doc/Frequent_Issues_While_Colaborating.rst: WARNING: document isn't included in any toctree

y si es esto, como puedo solucionarlo?

checking consistency... cpython/Doc/Frequent_Issues_While_Colaborating.rst: WARNING: document isn't included in any toctree

Esto es porque la página que acabás de crear no está incluída en el índice. Para resolver esto hay dos opciones:

1. agregarla a algún índice (no podemos en este caso)
2. marcarla como huérfana

Para hacer 2), debes agregar :orphan: al principio de tu archivo.

Muchas gracias @humitos ahora ya está :) la dejo en draft para trastear más la parte de lo de Mac en otro momento.

@humitos , @raulcd , aunque está chiquitita todavía por mí ya podéis mergearla porque así la gente puede también contribuir a ella (por ejemplo, puse una seccion con lo de windows). Yo intentaré averiguar el tema diccionarios, aunque para esto si alguno de los que teneis máquina linux podeis trastear un poco también iría genial. (Me refiero a lo de que todos tengamos unos mismos diccionarios de pospell para los chequeos)

gracias @humitos, he vuelto a hacer commit aplicando tus sugerencias y trayéndome los últimos cambios de la 3.8. He empezado con lo del windows pero ahora me quiero concentrar en mi traducción, así que prefiero hacer merge cuando esté revisada. gracias!