Create Styleguide

[zoombear]

Is your feature request related to a problem? Please describe. Tech By Choice has developed a bit of a styleguide and has it written in a google doc. We'd like to live somewhere more formal. https://docs.google.com/document/d/1SMHFW8pFma0XAV58IzSw9LjVMgYds9Xdp-0x8CuqpVM/edit?usp=sharing

Describe the solution you'd like Research solutions for hosting a more formal styleguide, get buy in from the TBC community, and then translate the styleguide from the google doc to the formal solution.

Describe alternatives you've considered

• Create a page on the website with the styleguide
• Use a service to host the styleguide

Additional context We might also want to add to and/or clarify the styleguide!

[monika]

I did some research and it looks like we've got quite a few options!

I focused on branding and visual style guides because there’s some overlap within style guides of options that were more of a technical style guide (UI toolkits, design systems, or pattern libraries) with coding conventions and markup examples than an overall look and feel for a brand. There were more technical style guide than branding style guide options.

There were some tools like Brand.ai that exported assets to desktop apps like Sketch or Adobe Illustrator but I think requiring someone to have access to these apps to update the style guide would be prohibitive so I'm not including them.

Hosted Options All of these have free but restrictive tiers, and paid tiers above that:

• https://www.frontify.com/
• https://www.misheneye.com/
• https://openbrand.com/

Self-hosted / Tool Kit(ish) Options These lean more towards pattern library, technical style guides but we could modify them for our needs:

• http://hugeinc.github.io/styleguide/
• http://fbrctr.github.io/
• https://gitlab.com/identihub/Identihub
• http://bradfrost.github.io/style-guide-guide/
• http://bjankord.github.io/Style-Guide-Boilerplate/