Better Comments

[iacore]

Nim doc comments are not as free as normal comments.

It would be nice to support this:

const a =
  ## Hello
  block:
    1

[saem]

The above was discovered/resurfaced in this PR conversation: #719 (comment)

---

Supporting docs as the example above and/or perhaps via an associativity marker to allow for lede docs:

##> Hello, I attach to `a`
const a =
  block:
    1

[iacore]

What's "lede docs"

[saem]

I was being flowery with language, basically the docs act as the first/opening item followed by the code containing the symbol with which to associate.

Definition of lede:

the opening sentence or paragraph of a news article, summarizing the most important aspects of the story.