Episodio 8 - Documentacion: the good, the bad, and the ugly Fullstack Nights Podcast
-
- Technology
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
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
57 min