ban all video-only documentation
@annika omg
@rowan incredibly this
if this gets more exposure than my carefully-written blog post i'm gonna fuckin scream
AHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHH
@rowan That exists??!
@ablwr APPARENTLY
source: caldera forms
@rowan all documentation is now podcasts
@gaditb NO BAD you can't even mute podcasts
@rowan all documentation is now portrayed in the form of an off-off-broadway play
@gaditb all documentation is now protected by silverlight DRM and plays two seconds before it has to buffer again
@rowan all documentation is done in EXTREMELY terse records of arguments between the students of the students of the original writers, but since some of that was ambiguous/unclear it is supplemented by the students of the students of THOSE arguers arguing about what they meant
in Aramaic this time.
@gaditb oh no
@rowan all documentation is spread out on a corkboard, with links similarities and citations expressed using red string
@gaditb oh no oh no
look we're only making explicit what is already implicit
people don't want documentation to exist
they hate making it
so if we ban it, we're really just giving the people what they deserve
@sydneyfalk @rowan people love documentation to exist, they just don't want to write or read it
tragedy of the doc-mons
@cwebber @sydneyfalk @rowan life goals: professional doc-mom, "do[ing] basic science on your libraries to see how they work"
@sydneyfalk @mxsparks @cwebber di-gi-mo-n digital wait fuck
plus there's the chance it'll briar patch
"oh, NOBODY CAN WRITE DOCS"
"oh YEAH?! YOU'RE NOT MY MOM! I'M GONNA WRITE DOCUMENTATION!"
this could totally cause a LOT of documentation
@rowan
Video-only Docs are evil incarnate, period.
@rowan I already ranted about this in 2 other places but: a "video demo" I received today was a 170MB animated GIF