@mhoye there seems to be a lot of room for more interactive documentation, where the user can build intuitive understanding through simple, visual explanations. For example, https://regex101.com
I've been prototyping a CLI app documentation explorer in this style that breaks down commands/arguments with visualisations and examples. It's very simple, but the improvement over a wall of text seems pretty clear to me. Just a shame this kind of thing doesn't already exist.