Currently making sections etc. into the styleguide takes a lot of manual work. Also the styleguide demo is not very pretty or user friendly.
There are some commonly used guidelines for making styleguides and documenting the css (or sass), like KSS: http://warpspire.com/kss/styleguides/
We could look at some existing solutions and think about either changing to a different implementation or improve our current one. Opinions?