As someone fairly new to Julia, and coming from Matlab, I very much agree that interactive examples are great when learning something new - and something I’ve been missing on several occasions!
I also feel that much of the Julia documentation is pretty technical and involved. I have not had the time to read the manual from start to finish, the only way I could start using Julia was to force myself to hit the ground sort-of-running, and I often find that I don’t understand a section of it quickly enough when taken in isolation.
In one of the PlutoCon talks it was mentioned how solving the two-language problem has unearthed some problems of having an unusually diverse userbase. Quite a few users are not just learning Julia, they’re also learning to program for the first time. And then my case right now, which probably resonates with many in the research community: I’m trying to use it to do computations while learning no more than needed, as quickly as possible. And many users are advanced, some very advanced: deeply knowledgeable about computer science and quite interested in the internals of it all.
A bit too often I feel like the documentation is better suited to advanced users at the cost of comprehensibility to other types of users. At the same time, I would not want to lose that information, I believe it important for the ecosystem that we provide deep information for advanced users. And when I have a bit more free time I as well aspire to understand as much as possible.
But I think there should also be a shallow version of the Julia manual, that skips over a lot and gets a new user going as fast as possible. And I think this documentation would greatly benefit from being interactive!