Generated by SassMeister.com.

SassMeister-input.scss

// ----
// Sass (v3.3.8)
// Compass (v1.0.0.alpha.19)
// ----

// One thing I do like in programming languages
// is the ability to "type" variables,
// especially in functions signatures. 
// 
// Unfortunately, Sass does not allow this. So
// I was thinking we could add the type right 
// before the argument in the signature.
// 
// This seems like a decent way of showing what
// is expected by the function/mixin.
// 
// What do you think?
// ---

// Mixin
// ---
// @param [color] $theme: color from theme
// @param [map] $options: options 
// ---
@mixin whatever(/* color */ $theme, /* map */ $options) {
  // ...
}

I like it. And we might as well use JSDoc to document it with additional details, more in this fashion:

/**
 * Mixin description here.
 *
 * @mixin whatever
 *
 * @param  {Color} $theme   Some color...
 * @param  {Map}   $options A map of options...
 * @param  {Unit}  [$size]  An optional size value...
 *
 * @return {Class} Here we could even describe what will be the outcome of our mixin...
 */
@mixin whatever(/** color */ $theme, /** map */ $options, /** unit= */ $size:16px) {
  // ...
}

@elussich Is JSDoc working on Sass files?