Concatenate sections

[styledown]

Concatenate sections

[nickisnoble]

I tend to write all my docs for a section at the top of the file. (I'm using scss, so in this case it would be something like _buttons.scss.

Then my example block would look something like this:

@example
a.button This is a button
a.button.primary This is an action button
a.button.secondary This is a secondary action button
a.button.cancel This is a cancel button

It will all render ok even if the styles come later or in a different file, because the output is static (so it uses the whole stylesheet(s) anyway, so long as it/they are included in config.md).

---

Otherwise, if you generate your documentation from a Markdown file rather than css comments, you can have them all in one section. I like doing it this way, having the docs be separate is a little better for organization, and my team likes it because they can edit the copy, if need be, without dealing with real code.

[SammyM]

Okay, thank you.