I was leaving the $modifierClass in the example HTML so it was clear where to insert in the modifier classes in complex examples with multiple html tags. 

For example, here's the demo html for a grid__row__span--offset1 modifier.
```html
<div class="grid grid--styleguide">
    <div class="grid__row">
        <div class="grid__row__span1 $modifierClass">span</div>
    </div>
</div>
```
I wanted the example code to be clear that you put the modifierClass on the most inner div. 

Thoughts? Is there a better solution? I agree that it can be weird to see $modifierClass in the example.