39: Making Documentation Sexy | Juan Luis Cano, Read the Docs

Data For Future - A podcast by Tammy & Pavlo

Categories:

Coding is cool, but badly documented codes are not. Although documentation at first glance does not seem to be the sexiest task for developers and data scientists, it is ultra essential for any project to scale and for further collaboration. Juan, the developer advocate of Read the Docs, is here with us today to introduce why we should think about documentation as an empathy, what are the tools to enable simple and clear documentation, and what are the principles to abide when documenting. Furthermore, we also touched upon the importance of open-source community, diversity in tech, and data ethics. Listen in! Contact- [email protected] twitter linkedin Related Resources- -Why you should document your work as a data scientist -Surveys about documentation Digital Ocean State of API Postman Technical Communication Developer Documentation Trends -Diátaxis Framework for documentation - Readme Checklist