In my upcoming book Modular Web Design, I describe how to document a component with attributes much like a pattern: use when, guidelines, a taxonomy of variations and examples, and a picture much like a pattern’s “sensitizing example.”

For that picture, I’ve come up with a table of options with pros and cons, and would love your feedback!