Required arguments highlight

[pascalduez]

A bit nit-picking here, but could be interesting to have a visual or text information on required arguments (without a default value).
It's already stated whether the argument has a default value or not (at least in comments...).
But that could make it more straightforward I guess.

[KittyGiraudel]

In Sass, required arguments are those who do not have a default value.

[pascalduez]

In Sass, required arguments are those who do not have a default value.

Yes, and they also need to be before any named argument in the signature.

I'm more thinking about some sort of visual differentiation in generated doc.
Just because we can.
(Doesn't mean we should... :)

[KittyGiraudel]

What do you have in mind?

[pascalduez]

What do you have in mind?

Maybe a different color, or a small label, or border.

Let me use SassDoc a bit more and generate docs for some of my projects, and it may make sense afterward. ;-)

[KittyGiraudel]

Alright. Keep me updated :)

[KittyGiraudel]

I'd like to close this any time soon. Hit me up @pascalduez. :)

[pascalduez]

So here are some quick mockups. Actually, I like the idea but wondering if it's all worth.
You judge, you close ;-)
It should ideally make the difference between true required args, and defaults without comments...

1

2

3

[KittyGiraudel]

Okay for the *. I'll do that tonight.

[KittyGiraudel]

After thinking about it, I feel like the — in Default value column is enough. If you think otherwise, feel free to open this issue back so we can chat about it.