3 ms·
> please consider using plain text instead You do understand this is a false dichotomy? You can have both. Some people would rather watch a video and follow al
by awalton 7y ago
> please consider using plain text instead
You do understand this is a false dichotomy? You can have both. Some people would rather watch a video and follow along, whereas others get more out of reading text... and both fit neatly on a page right next to one another.
- StavrosK 7y agoFor double the effort, which not many people go to.
- masukomi 7y agosure, if you're going to be lazy and only do one do text. HOWEVER advocating for the lazy path amongst fellow practitioners is not a great strategy to promote quality output. Documentation is hard. Good documentation is harder. There are many occasions where video and video-like things are good for getting a feel for something and just plain text is good for reference. We shouldn't be saying "just use text because you probably won't bother doing everything you should". We should be saying "Hey, video, still images, and text all combine to make great documentation and help people to understand and use your tool / product." They take time, but we should care about our users, and thus we should take the time to support them.
- nickcox 7y agoNot sure it's double the effort. Once you've written the textual version, you pretty much only need to copy and paste it into a terminal to produce the asciicast version. That's how I did the animations for this Powershell tool. https://github.com/nickcox/cd-extras https://github.com/nickcox/cd-extras