Explicitly disallows using the $ symbol inside the description/comment section of a @require annotation. It is allowed in @returns and the like, so I wonder why it's not here.
That's my first issue. My second issue is that I had to look up in the code to figure out why SassDoc was crashing. I was using several annotations with the $, so pin-pointing the wrong line was impossible with just my code. It should throw a human-friendly error (which, being this a regex thing, could be quite a challenge to say "hey, no money here!", but could be easy to say "wrong syntax for description" or something... Instead of:
The current regex:
Explicitly disallows using the
$
symbol inside the description/comment section of a @require annotation. It is allowed in @returns and the like, so I wonder why it's not here.That's my first issue. My second issue is that I had to look up in the code to figure out why SassDoc was crashing. I was using several annotations with the
$
, so pin-pointing the wrong line was impossible with just my code. It should throw a human-friendly error (which, being this a regex thing, could be quite a challenge to say "hey, no money here!", but could be easy to say "wrong syntax for description" or something... Instead of:Don't you think?