Mejorar Docs

[SidVal]

En un principio arrancamos todo ésto del Docs (https://sidval.github.io/dev.web) con docsify.js.org, y pareciera funcionar correctamente, aunque tengo un par de ideas para agregar que me gustaría contemplar:

• [ ] Comentarios / Chat / Preguntas en la documentación
  • [x] Chat de GitChat [ver]
  • [ ] Disqus [ver]
• [x] Enlaces externos (diferenciarlos) - [issue en docsify]
• [x] Favicon
• [x] ¿Nuevas carpetas?
  • [x] Para distintas clases del curso. Leer más
  • [x] Ver re-organización del root - ejemplo
  • [x] Re-Organización
• [x] Poner cursos de Udemy en https://sidval.github.io/dev.web/#/curso/
• [x] Dominio - suspendido
• [x] Mejora diseño y personalización del sitio - suspendido

---

Este es de los primeros issues que se abren a este repo, el mismo es para almacenar ideas. Se irá editando este mismo mensaje a medida que vayan surgiendo ideas, y se vayan desarrollando en los siguientes comentarios.

[SidVal]

TOC a la derecha [por el momento: SUSPENDIDO]

Analizando http://grow.io me doy cuenta que es muy avanzado el desarrollo, no lo veo tan simple como docsify ahora mismo, donde la sola edición del archivo MD automáticamente actualizada toda la estructura, aunque aún no entienda bien cómo funciona el tema de los niveles en TOC.

[SidVal]

Favicon

• Habría que elegir la imagen, se está probando con ésta: https://sidval.github.io/dev.web/favicon.ico falta darle más transparencia, pero al menos está funcionando :+1:
• Leer: https://github.com/audreyr/favicon-cheat-sheet
• Leer: https://www.w3.org/TR/html5/links.html#link-type-icon

[SidVal]

Nueva carpeta: "/clases/"

Se agregó más contenido en una subcarpeta, y tiene su propio sidebar. Ver /clases/

[SidVal]

Cambiar color del marcado en markdown

Ejemplo: https://sidval.github.io/dev.web/#/capitulo2?id=padding

El theme por defecto, es vue.css. Es demasiado rojo. 👎

Fuente: https://github.com/QingWei-Li/docsify/blob/master/lib/themes/vue.css

---

Nuevo diseño "Green"

https://github.com/SidVal/docsify/blob/green/lib/themes/vue.css

Se está usando este CSS en el sitio 👍

[SidVal]

Dominio [suspendido]

Ir pensando si optar o no por un dominio para este sitio.

Opciones gratis:

• https://dns.js.org/ --> https://github.com/js-org/dns.js.org/pull/2009

En js.org rechazaron el nombre webmaster, y lo agregaron a la lista de nombres restringidos. ¬¬

---

Suspendido hasta nuevo aviso 🏗

[SidVal]

Otras ideas suspendidas

• [ ] Ver otros sitios en docsify para sacar ideas: https://docsify.js.org/#/awesome?id=showcases

• [ ] Como en otros sitios de documentación, aparte de la "TOC" (tabla de contenido) a la izquierda, estaría bueno tener una TOC a la derecha por capítulo, para que vaya abriendo contenido a medida que se va leyendo y el lector sabrá cuánto o qué temas le faltan para terminar el capítulo.

  • [x] Todavía no me decido al 100% sobre la utilidad y/o viabilidad de éste punto [por el momento, lo SUSPENDO]
  • [ ] Otra visualización interesante de lo que sería bueno tener en Docs: https://code.visualstudio.com/docs
  • [ ] https://github.com/facebook/Docusaurus [demo] ... leer si corre en github

[SidVal]

Tema GitTalk / ver en docsify

Analizando esto: https://gitalk.github.io/ Me doy cuenta que si pongo GitTalk cualquiera que quiera comentar debería tener su perfil en GitHub. Sería demasiado exclusivo para desarrolladores creo.

Quizás si busco un "Disqus" o algo similar, podría ser más aceptable. Ver: https://docsify.js.org/#/plugins?id=disqus

[SidVal]

Logos

https://github.com/michaelrambeau/bestofjs/tree/gh-pages/logos

[SidVal]

Diferenciar enlaces externos

Ref: https://github.com/QingWei-Li/docsify/issues/501 - Closed

---

Quora usa una clase .external_link para representar los enlaces salientes:

a.external_link{background:url(//qsf.ec.quoracdn.net/-3-images.new_grid.external_link.svg-26-aef78ead48f1f1e2.svg) no-repeat right .3em;padding-right:15px;background-size:10.5px}

[SidVal]

Mejora Diseño y personalización

Ver: https://github.com/jhildenbiddle/docsify-themeable

---

Update: 16/07 - suspendo, no me cierra hacerlo ahora a ésto.

[SidVal]

Listas Awesome

Se agregan algunas en el readme del contenido, recordar siempre antes de editar el contenido, debe editarse el index.html

[SidVal]

Cursos Udemy

• Agrego tarea nueva para buscar cursos en Udemy, y publicarlos en https://sidval.github.io/dev.web/#/curso/ (por ejemplo).

[SidVal]

Agrego nuevo curso

Se agregó el contenido del curso de Noelia Silva (que ahora se llama Programar desde tu casa). Ver: https://sidval.github.io/dev.web/#/curso/ns/