Concatenate sections

[SammyM]

Would it be possible to concatenate sections which have the same titles of the following format?:

/***
 * Buttons
 */

I have button styles in different files and I would like to add them all to the same section instead of having multiple sections with the same title in different locations within the style guide.

[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.