Let's throw a few more code samples early on. If nothing else, API definitions to go along with text. Here is some feedback from a reader to contextualize the issue:
it would be nice to have more real code in the Intro section of the docs, ideally with some real usable code on the first page, Intro -> Overview.
I definitely expected to see some real working code on the Getting Started -> First Contract page. It feels like things stay at 0 code for really long, then in the "Editing the Sample Contract" page it goes into fine-granularity code detail mode. If you can start introducing code much earlier, and at a higher-level, it might ease people into that section better.
Let's throw a few more code samples early on. If nothing else, API definitions to go along with text. Here is some feedback from a reader to contextualize the issue: