Omer is the CTO and Co-Founder of Swimm, making Continuous Documentation an integral part of the development lifecycle. Omer is the founder of Check Point Security Academy and was the Cyber Security Lead at ITC, an educational organization that trains talented professionals to develop careers in technology. Omer has a MA in Linguistics from Tel Aviv University and is the author of Computer Networks and the Brief YouTube Channel.
Documentation is Broken: Code-Coupled Docs for Modern Systems
Systems today are growing in complexity whether it's the infrastructure, multiple languages in use, distributed and high-scale design patterns such as microservices and much more. All of this leads to knowledge silos that developers run into when handling code areas they’ve never encountered before. This includes anything from onboarding into a new engineering organization, debugging or maintaining code they haven’t written, doing code reviews and many other common tasks.
However, documentation is fundamentally broken––and the way around this has been to either throw engineers into the deep end or to constantly be in a manual and Sisyphean maintenance process that is completely decoupled from the code.
In this talk I’d like to dive into the deep end on a new way of thinking about documentation - where it is continuous and code-coupled documentation. Developers deserve documentation that is easy to maintain, updates with code changes automatically or flags for human intervention, enables you to find the docs when you need them most - right inside your developer context and workflows (read: your IDE of choice), all this is possible and we’ll show you how..
Catch Omer's talk at Modern Frontends Live!