I have been doing longer screencasts these days. Some of them are for private consumption, and some are public. I am yet to master it fully. But I have come a long way. These are the tools that have helped me.
I like drawings to explain stuff. It’s probably the most straightforward way to document things. But the pain of traditional drawings is the inability to track changes to them. It’s easy to track changes to text or code by tracking them in a git. It’s not easy when it’s a binary blob which is what most images are. SVG format helps a lot. I use it as much as possible, but it’s still very verbose, and I think not easy to see the diff and understand what happened over time.
Over the years I have gathered a set of tools for effective documentation and communication. I use these tools to communicate on this blog, with my coworkers or anyone else that I want to share things with. Now that all of us are working remotely, they have become very important. I am listing...