I will be speaking in PyCon Estonia 2019
I will be giving a talk titled "Contemporary Documentation" in PyCon Estonia in Tallinn, Estonia on October 3rd.
"Why did they do this?" is a thought many of us have faced when looking at an older codebase. Documentation in forms of code comments, readmes and API specs are kept up to date so they cannot answer questions of old. But not all hope is lost: with good quality issues, pull requests & code reviews and git commit messages you can gain perspective into the time when those decisions were made.
In this talk I will walk through how aforementioned ways function as contemporary documentation and how to write good issues, pull requests, review comments and git commit messages to provide answers to why.