IDK who else needs to hear this, but some people still do:
- videos are not documentation
- podcasts are not documentation
- discord is not documentation
- a web forum is not documentation
in addition to having a mismatch from an Information Architecture standpoint, *each* of these introduce barriers to entry and accessibility problems
Your video and your podcast are not accessible. Your video, podcast, or discord are not searchable. Discord permabans people for trying to improve their client
@mattly also searchability, availability offline/away from the office, usability in a datacentre environment (noisy, busy, potentially physically hazardous if some muppet has the floortiles up without warning again).
my basic rule of documentation is:
can you print it out, stick it in a folder and refer to it during a full power-outage?
you don't actually need to do that for all the docs but at a basic level it sets the expectation that you might need it in less than ideal circumstances
@mattly (also, speed-reader. don't make me watch someone read out their pre-written script at the speed of a 5-yo kid taking their class reading turn reluctantly. I will *not* be watching more than 10 seconds, and will live without whatever the answer might have been instead)