kneath/kss — Issue #16: How should HTML in a description be handled?
Author: audionerd
Created: 2011-12-08 07:04:19+00:00
State: open

According to the spec:

> CSS rules that depend on specific HTML structures should describe those structures using notation. For example:

> // A feed of activity items. Within each , there should be many
> //

s which are the feed items.

But the spec doesn't indicate how those pseudo-HTML blocks should be displayed in the output of a generated styleguide.

I'm assuming they should be output as plain-text, escaped, and not actually inserted as HTML?

Personally, I would actually prefer if there was some way to include raw HTML examples right in the KSS docs. I think keeping the HTML next to the CSS could – in certain cases – be helpful.

e