Usar markdown?

[LucasFA]

A menos que haya una razón específica (como originalmente requisitos del proyecto, de que la documentación esté en este formato) Markdown me parece más accesible puesto que permite leer la documentación online aquí en github sin necesidad de descargarla, además de ser un formato de texto en vez de un binario.

He generado este repositorio usando en bash:

for file in ./*.docx; do echo "$file"; pandoc --from docx --to gfm  "$file" -o "./${file%.*}.md"; rm "$file"; git add .; git commit -m " Convertido archivo a Markdown: $file"; done

Hay errores por arreglar antes de mergear, sobre todo en títulos y la tabla de contenidos, pero es, supongo, un inicio.

Qué necesito

para trabajar en esto: confirmación de que sería mergeado una vez terminado. Si es así, hago esto bien y hago una PR buena - probablemente modificaría las commits que hay aquí

[LucasFA]

Si el usuario final necesita algo más visualmete apetecible que un archivo de texto markdown (que lo entiendo completamente para usuario finales), se les podría enlazar a una release que compile la documentación markdown a pdf.

Así se consigue lo mejor de los dos mundos