Episodio 8 - Documentacion: the good, the bad, and the ugly

Fullstack Nights Podcast

Episodio 8!

En este episodio hablamos sobre que es buena documentación para projectos de software. Como manejamos y distribuimos documentación y como Froi mete la pata por Twitter.

Temas

Documentation: the good, the bad, and the ugly

• Un README no es documentación.
• HTML es el formato rey para distribución de documentación
• Herramientas para trabajar con documentación
• ¿Qué es buena o mala documentación?
• Como meter la pata en Twitter como Froi.

Proyectos y organizaciones dedicadas a documentación:

• Read the Docs - https://readthedocs.org/
• Write the Doc - https://www.writethedocs.org/

Herramientas para documentación

• Github Wiki - https://help.github.com/en/articles/about-wikis
• Pandocs - https://pandoc.org/

Plugs/Picks:

Froi

• Ash Center for Democratic Governance and Innovation - https://ash.harvard.edu/
• NodeConf Colombia - https://colombia.nodeconf.com/
• Pycon Latam - https://www.pylatam.org/
• Autonomous ErgoChair 2 - https://www.autonomous.ai/office-chairs/ergonomic-chair

Giovanni

• Dash - https://kapeli.com/dash
• Alternativas a Dash: Zeal https://zealdocs.org/ y DevDocs https://devdocs.io/
• Mosh (mobile shell) - https://mosh.org
• Mi blog - https://gcollazo.com

Participantes y por donde los puedes seguir:

Giovanni

• Twitter/gcollazo

Froi

• Twitter/skfroi
• Twitch/skfroi