Retocar algunos pasos de la instalación en ambos idiomas

[maeriens]

Estuve un rato largo para poder instalar Wollok en mi compu, y en el grupo se preguntaron algunas cosas que por ahí no estaban claras acá, así que dije "bueno porqué no aclarar algunas cosas en la documentación mientras se use"

README:

• Agregué el parámetro --livereload para ver los cambios en vivo, tarda un segundo en actualizar pero funciona
• Sugerencia también de poder usar --open-url así abre directamente la página cuando se corre el comando
• Saqué la info del output directo de Jekyll porque por ahí no suma mucho en esta parte
• Otros retoques mínimos de formateo de Markdown

download.md:

Simplmente apliqué lo que se comprate con instalacion.md, descrito abajo

Instalación.md:

Generales:

• Agregado del targer="_blank" a la mayoría de los links para que abran en una pestaña nueva y no perder el foco de la documentación
• Cambio algunos tags <i> por <em> para no confundirlos con el tag de íconos de Font Awesome
• Elimino algunas clases que no existían (nx, languaje-javascript)
• Elimino los div alrededor de las secciones de código porque no eran necesarias
• Elimino el último salto de línea en todos los <pre> para que no genere una línea extra vacía
• Cambio el ID del último h4, porque repetía el anterior ("apuntando-la-jdk-correcta-en-ini-de-wollok")

Pre-requisitos:

• Usar la nueva URL para descargar el JDK de Adoptium (Resuelve en el issue #57)
• Sugerencia de usar el archivo .msi o .pkg para el instalado porque es más simple para el usuario

Bajar entorno local:

• Sugerencia de no instalar Wollok en una carpeta con espacios (Mencionado en #39)
• Un comentario: Los docs dicen que podés bajar el .zip o el .tar.gz, pero los tres archivos linkeados son .zip, no sé si afecta algo eso

Troubleshooting:

• Menciono el error de instalado en una carpeta con espacios (De nuevo el issue #39)
• Cambio el nuevo link para solucionar el tema de la aplicación no firmada
• En el error de OSX de "Failed to create the virtual machine" agrego un link a otra sección que detallo más adelante
• Pongo la 3 formas de obtener dónde está instalado Java. Para OSX/Linux, usando el .pkg no me crea el JAVA_HOME pero funciona igual con otro comando que detallo ahí. También enumero los comandos tanto para cmd como para PowerShell.
• Donde dice que hay que apuntar al JDK en el wollok.ini, la verdad a mi en MacOS me funcionó mejor el editar solamente el Info.plist. Esto me pareció mejor por una serie de cosas
  • Esto toca un poco el issue #29
  • Es más fácil acceder al archivo porque está directamente dentro de la carpeta Contents
  • Si se abre con algún editor de código, ya tiene syntax highlighting
  • Hacer esto también elimina el error de que no se pudo crear la Virtual Machine de Java
  • En el mismo archivo hay un comentario que dice exactamente qué hacer. Descomentarlo y poner el path correcto es más simple porque sirve como guía
  • Las imágenes la generé con Carbon
  • No lo pude probar en Windows. Pero si fuera similar, es más simple de incluso a futuro hacer un video con todos los problemas e ir solucionándolos de manera uniforme y agnóstica de OS. Por eso dejé esto como parte de Linux/OSX y lo que estaba antes como parte de Windows.

[fdodino]

@asanzo @maeriens denle gasssssss!!! 👏🏼 👏🏼 👏🏼