Help understanding
Dark v1 problems
Users often have problems understanding what they're seeing, for a number of reasons:
- they are learning the language for the first time, and are unfamiliar with the constructs, frameworks, types, functions, etc
- the editor prints things in an ambiguous way
Solution
We already partially solve this with traces, where we show actual values. However, we can show more information to help:
- show the type in the live value display
- show
(i)
info icon on framework elements, types. This will show a doc for this, perhaps with a link to more information - an "AST view" where you can see the AST of this code, and when you mouse over particular code you see the AST you're selecting