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!
Juan Luis Cano is an Aerospace Engineer with a passion for scientific computing, applied math, programming, education, and outreach. He works as Developer Advocate at Read the Docs, where he works with scientific projects to improve their documentation. He has worked as software engineer at the space, consulting and banking industries, and as a Python trainer for several private and public entities.
Apart from being a long time user and contributor to many projects in the scientific Python stack (NumPy, SciPy, Astropy) he has published several open source packages, the most important one being poliastro, an open source Python library for Orbital Mechanics used in academia and industry.