Building Style Guides for Humans

The front-end development community has certainly embraced style guides. At past Drupalcons I've described how to construct components and how to integrate style guides in your front-end workflow. In this session, we will discuss how to create and manage your style guide and how to make it maximally useful.

The primary questions we should be asking when starting our style guide are:

Who are you building a style guide for? And what are their needs?

Front-end developers, certainly, are a key constituency, but they aren't the only ones. Site owners and builders, designers, lawyers, and automated tools can all use style guides and all have different needs.

Once we have discussed the goals of our style guide, we will go through practical examples of building and organizing a Twig-based component library and how to integrate it with Drupal.

We will be discussing:

• Criteria for evaluating a style guide tool
• How to organize a style guide for all users
• Deciding what information goes in a style guide
• Using KSS to build a style guide
• Using Twig components in Drupal