Finally started watching a (long!) video about the UE Gameplay Ability System. I'd tried to get a sense for it from the written docs, but they just don't go into enough detail on how & why you might use it in practice. More like 1 paragraph on each bit & then "go read the Lyra source". Needing to watch a *3h* video has been a blocker on me bothering to dig more before now.

I don't think it's something I'll use on this game, but I can definitely see the utility. Just a lot of moving parts!

Tech industry, please hire more writers. I can happily read docs for 3h and get much more out of them than watching a video for 3h. And while I'm watching the video, I'm making copious notes so that I don't have to watch the video *again* later to refresh my memory. If it was written down in the first place with good indexing I wouldn't have to do that. Video is such a crap way to document things.

@sinbad Different folks learn in different ways. Video is so important when you need to show, or for the younger generation who learns from videos. Docs are the ultimate details for those who learn from reading, and to provide the 'golden source' information. Docs are easier to update than video so go out of date less often.

Good content starts with good docs!

@JimBobBennett I agree, my problem is when companies treat video as the primary and the "golden source" has huge gaps

@sinbad so much this!

Written docs as the golden source.

Video should only be the golden source if you have to show something, such as with hardware short videos can be better than text.

Otherwise start with detailed docs, user guides, quick starts etc. Video is great, but is phase 2 - and should be split into short form to answer questions, as in this video shows you X and only X, with longer form tutorials. I have so many opinions in this space...