Explore guide generators

[basham]

Styleguide Generator Roundup article categorizes generators into those for Design or Documentation purposes. Explore the strengths of these tools and if they are worth adopting over a more flexible Assemble project.

Generators for Designing

If you're still trying things out, exploring, or designing in the browser these are the tools for you.

• Pattern Lab
• Style Prototype

  Generators for Documenting

If you're working with existing designs, sites, or patterns consider one of these:

• Kalei, KSS, and Styledocco
• Hologram

[basham]

The Style Guide Guide: Style guides organized by technology (Node, Gulp, Grunt, Ruby, PHP).

[basham]

Research from Feb 11, 2014:

DocPad

https://github.com/bevry/docpad

• Static or dynamic pages.
• Community plugins.

Wintersmith

https://github.com/jnordberg/wintersmith

• Little setup.
• Easy to drop existing static content and get going.
• Not very Grunt-y.

Blacksmith

https://github.com/flatiron/blacksmith

• Comparatively discontinued. Last commit July 2013.
• Not as much community support as DocPad or Wintersmith.

Assemble

https://github.com/assemble/assemble

• Grunt, Yeoman.
• New. First release 0.4.0, June 2013.
• Pretty active.
• Dane Petersen’s Propeller basically ties Assemble to some good starting points (Handlebars, RequireJS, etc.). And he’s made a Propeller Yeoman generator.
• Official support for Handlebars template engine.
• JSON, YAML, YAML Front-Matter (YFM) data.
• Super DRY.

[basham]

Lots of promising work on upcoming Assemble 0.6, including an Assemble plugin for gulp.